everyinfra-cli — Claude Code skill: features and installation
The everyinfra-cli Claude Code skill uses a command-line client to retrieve platform data, search the web, and solve CAPTCHAs. It activates for tasks involving those services when a terminal is available.
Apache-2.0 ★ 681 updated 2026-10-24
npx skills add everyinfra/everyinfra-agent-plugins --skill everyinfra-cli -a claude-codeWhat everyinfra-cli does
The skill calls everyinfra, a CLI client for EveryInfra services: public platform data, web search, CAPTCHA solving, and an OpenAI-compatible AI API. Sources include TikTok, Amazon, Instagram, and Google Maps. Results can go to files or command pipes, keeping large outputs out of the chat context.
The CLI requires Python and the installed everyinfra package. Install it with pipx install everyinfra, uv tool install everyinfra, or pip install everyinfra. Paid calls need an EveryInfra key and account balance. Use --dry-run to preview a request and estimated cost, or set --max-cost-usd for a batch budget. The catalog and capability descriptions work without a key.
What it helps with
- retrieve public data from TikTok or Amazon
- search the web for relevant pages
- solve a CAPTCHA during a task
- process rows with the AI API
Example prompts for the agent
- Fetch public TikTok comments and save the result as
result.json. - Search the web for pages about this topic with EveryInfra.
- Use
everyinfrato solve the CAPTCHA for this task.
How to install everyinfra-cli
1Skills CLI (Vercel)
npx skills add everyinfra/everyinfra-agent-plugins --skill everyinfra-cli -a claude-code2Manually: put the files in place
~/.claude/skills/everyinfra-cli/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/everyinfra-cli/
1Skills CLI (Vercel)
npx skills add everyinfra/everyinfra-agent-plugins --skill everyinfra-cli -a codex2Manually: put the files in place
.agents/skills/everyinfra-cli/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add everyinfra/everyinfra-agent-plugins --skill everyinfra-cli -a cursor2Manually: put the files in place
.cursor/skills/everyinfra-cli/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install everyinfra/everyinfra-agent-plugins plugins/everyinfra/skills/everyinfra-cli2Manually: put the files in place
.github/skills/everyinfra-cli/SKILL.md1Skills CLI (Vercel)
npx skills add everyinfra/everyinfra-agent-plugins --skill everyinfra-cli -a gemini-cli2Platform CLI
gemini skills install https://github.com/everyinfra/everyinfra-agent-plugins --path plugins/everyinfra/skills/everyinfra-cliManually: put the files in place
.devin/skills/everyinfra-cli/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add everyinfra/everyinfra-agent-plugins --skill everyinfra-cli -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about everyinfra-cli
How do I install everyinfra-cli in Claude Code?
Run npx skills add everyinfra/everyinfra-agent-plugins --skill everyinfra-cli -a claude-code. The skill file is at ~/.claude/skills/everyinfra-cli/SKILL.md.
What does everyinfra-cli do?
It uses the EveryInfra CLI for platform data, web searches, CAPTCHA solving, and the AI API. Results can be written to files or passed through command pipes.
What does everyinfra-cli require?
It needs a terminal, Python, and the installed everyinfra package. Paid calls also require an EveryInfra key and account balance; the catalog works without a key.
Source text
SKILL.md · Apache-2.0
---
name: everyinfra-cli
description: Fetch public data from 100+ platforms (TikTok, Amazon, Instagram, Xiaohongshu, Google Maps and more), run web searches, solve CAPTCHAs and call an OpenAI-compatible AI API with the `everyinfra` command-line tool and one EveryInfra API key. Use it when a task needs platform data, search results or a CAPTCHA solution and a terminal is available.
---
# EveryInfra CLI
`everyinfra` is a thin command-line client for the EveryInfra API: platform data, web search, CAPTCHA
solving and the AI API, all paid from one wallet with one key.
Install: `pipx install everyinfra` (or `uv tool install everyinfra`, or `pip install everyinfra`).
Check the setup with `everyinfra doctor`.
## CLI or MCP
- Use the CLI when you have a shell: output goes to files and pipes, and large results do not fill your context.
- Use the MCP server (`https://api.everyinfra.com/mcp`) in chat apps without a terminal.
`everyinfra mcp-config --client claude|cursor|codex|vscode` prints the config.
## The key
The CLI reads `--key`, then `EVERYINFRA_API_KEY`, then the key saved by `everyinfra login`.
Never print the key, put it in a file you share, or include it in a support ticket.
The catalog, `describe`, `captcha types`, `whats-new` and `--dry-run` work without a key.
## Standard flow
1. Find the capability (free): `everyinfra catalog --find "tiktok comments"`.
Search tools: `everyinfra catalog --line search`. CAPTCHA types: `everyinfra captcha types`.
2. Read its contract (free): `everyinfra describe tiktok/comments`. It lists the parameters, allowed values,
returned fields, the price and how paging works.
3. Preview the call (free): `everyinfra data tiktok comments -p url=... --limit 50 --dry-run`.
It prints the exact request and the estimated cost. Nothing is sent.
4. Try a small real call: `--limit 5`. Check the result before you spend more.
5. Run the batch with a budget: `--max-cost-usd 2 --output result.json`. The CLI does not send a call whose
estimate is over the budget.
Ask the user before a batch that costs more than they expect. Every paid command prints the charge and the
balance on stderr. `everyinfra account` shows the balance; `everyinfra billing` shows the spend.
## Parameters
- `-p key=value` is converted to the type in the catalog (integer, boolean, array and so on).
- `-p key:=JSON` passes raw JSON: `-p urls:='["https://a","https://b"]'`.
- Repeat `-p` for an array: `-p urls=https://a -p urls=https://b`. Arrays of targets are charged per target.
- Slow capabilities or large limits: add `--async --wait`, or `--async` and later `everyinfra job JOB_ID --wait`.
- Paged capabilities: `--pages 3` follows `next_page_token`. Each page is a separate paid call.
## Output
- Data goes to stdout and messages go to stderr.
- Output is JSON when piped or with `--json`. Use `--jsonl` for one result per line and `--fields a,b` for
only some fields.
- For large results use `--output FILE`. Then stdout gets only a short summary.
## Exit codes
| Code | Meaning | What to do |
|---|---|---|
| 0 | OK | |
| 2 | Bad request (400, 422) | Fix the parameters. The error JSON on stderr has `param`, `did_you_mean` and `allowed`. |
| 3 | Auth or permission (401, 403) | Fix the key, or ask the user to top up (`ai_topup_required`) or enable a key permission. |
| 4 | Balance too low (402) | Ask the user to top up. Do not retry. |
| 5 | Rate limited (429) | Wait `retry_after` seconds from the error JSON, then retry. |
| 6 | Temporary failure (503) | Retry later. Failed calls are not charged. |
| 7 | Outcome unknown | Do not retry. The call may have run and been charged. Check it with `everyinfra requests --id REQUEST_ID` or `everyinfra job JOB_ID`. |
| 1 | Other | Read the error JSON. |
## Errors and support
Each error on stderr has the API's shape: `{"error": {"code", "message", "request_id", ...}}`. Keep the
`request_id`. When the error says the problem is on EveryInfra's side, draft a ticket with
`everyinfra support draft --subject ... --description ... --request-id ...`, show it to the user, and open
it with `everyinfra support open ... --yes` only after they agree.
## AI API
Accounts that have topped up can use the AI API at no charge: `everyinfra ai chat "..."` for one reply,
`everyinfra ai map --input rows.jsonl --instruction "..." --output out.jsonl` to label, translate or extract
fields row by row. `ai map` waits on rate limits and keeps the input order. Add `--resume` to continue a run.
Guide for agents: https://everyinfra.com/llms.txt
© everyinfra · Apache-2.0 · everyinfra/everyinfra-agent-plugins