Skip to content

Quickstart

Use Node.js 20 or later, with npm available. Choose your coding agent when running setup. For Codex:

Terminal window
npx --yes agent-data@latest init --codex
agent-data account

For Claude Code, replace --codex with --claude-code; other supported agents have their own flags. The command works in PowerShell, Command Prompt, Bash, and zsh. Paste your API key when prompted—no shell-specific environment-variable command is needed.

Setup installs the CLI and coding-agent skill and saves your API key. Restart your coding agent after installing its skill.

Describe the website or data you need:

Terminal window
agent-data search "YouTube video search and details"

Choose a returned API identifier and read its contract:

Terminal window
agent-data docs <api-reference>

Use a route and its required parameters from the docs. Replace the placeholders below with those values:

Terminal window
agent-data call <api-reference> <route-slug> --<parameter> <value> --dry-run
agent-data call <api-reference> <route-slug> --<parameter> <value>

The dry run previews the request. The second command makes the API call and uses your account’s allowance or credits. Your coding agent can perform the same discover → inspect → call workflow using the installed skill.

If the source has no public API, use parse with its URL and the data you want. If an API already exists but lacks an endpoint, add an endpoint. Both are free to build.

Prefer your client’s tool interface? Follow MCP setup.