Currents News API Documentation

Agent Skills

Agent Skills are install-ready packages that teach AI coding agents how to call the Currents News API safely: authenticate with a bearer token, build /v1/latest-news and /v1/search requests, keep your key on the backend, and handle pagination, rate limits, and errors. Instead of describing the API to your agent from scratch, you install a skill package and the agent already knows how to use it.

Need an API key first? Create a free account to get a CURRENTS_API_KEY before installing a skill.

Supported AI Agents

currentslab/news-api-skills ships one skill package, news-api-currents, with a target build for every runtime below. ./install.sh <target> copies or symlinks the right package into place.

Agent runtime	Install command	Destination
Mistral Vibe	`./install.sh vibe`	`$VIBE_HOME/skills/news-api-currents/`
Hermes Agent	`./install.sh hermes`	`~/.hermes/skills/research/news-api-currents/`
OpenClaw	`./install.sh openclaw`	`~/.openclaw/skills/news-api-currents/`
OpenCode	`./install.sh opencode`	`~/.config/opencode/skills/news-api-currents/`
OpenHands	`./install.sh openhands`	`~/.openhands/skills/news-api-currents/`
OpenAI Codex / Goose / generic AgentSkills	`./install.sh codex`	`~/.agents/skills/news-api-currents/`

One-line install

Stream the installer for any target directly from GitHub. Replace vibe with any runtime from the table above:

curl -fsSL https://raw.githubusercontent.com/currentslab/news-api-skills/master/install.sh | bash -s -- vibe

Or clone the repository first if you prefer a local checkout, and pass --link to symlink instead of copy:

git clone https://github.com/currentslab/news-api-skills.git
cd news-api-skills
./install.sh vibe --link

Set your API key

Every skill reads CURRENTS_API_KEY from the environment and keeps it server-side; it is never exposed to browser or mobile clients.

export CURRENTS_API_KEY="YOUR_API_KEY"

If your agent loads a persistent env file instead, add the key there. For Mistral Vibe:

mkdir -p "${VIBE_HOME:-$HOME/.vibe}"
printf 'CURRENTS_API_KEY=YOUR_API_KEY\n' >> "${VIBE_HOME:-$HOME/.vibe}/.env"

Restart your agent after installing so it can discover the new skill, then try a prompt like:

"Use news-api-currents to build a latest-news endpoint with caching and rate limits."
"Use news-api-currents to add Currents search with UTC date filtering."
"Use news-api-currents to design a safe backend proxy for Currents API."

Using Currents with Pi

If your agent is Pi, install pi-news-api instead. It is a Pi-native extension backed by Currents that adds a headline widget plus agent-callable tools for latest news and keyword search.

pi install npm:pi-news-api

Set CURRENTS_API_KEY in the environment before starting Pi, then use it directly from a prompt: "Show me the latest science and technology headlines" or "Search pi-news-api for central bank interest rates."

Why this matters

🔒 Secure by design

Credentials stay server-side; skills redact secrets from logs.

⚙️ Runtime-ready

One installer, tailored packages for every supported agent.

🚀 Production-minded

Validated filters, bounded page sizes, caching, and rate limits baked in.

Resources

currentslab/news-api-skills - skill packages and install script
pi-news-api on pi.dev - native Pi extension
Authentication - how CURRENTS_API_KEY works
Latest News endpoint and Search endpoint reference

Building your own skill? Any client that supports the Skills protocol can call Currents directly - contact support if you want us to list it here.