everyinfra-agent-plugins

# EveryInfra Agent Plugin

[![Validate public plugin package](https://github.com/everyinfra/everyinfra-agent-plugins/actions/workflows/validate.yml/badge.svg)](https://github.com/everyinfra/everyinfra-agent-plugins/actions/workflows/validate.yml)
[![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE)
[![Plugin version](https://img.shields.io/badge/plugin-v0.3.0-287A73.svg)](CHANGELOG.md)

> **EveryInfra** is data infrastructure for developers and AI agents: one API key for 409 data capabilities across 90 platforms — [Xiaohongshu (RedNote)](https://everyinfra.com/en/xiaohongshu-api), [Douyin](https://everyinfra.com/en/douyin-api), [TikTok](https://everyinfra.com/en/tiktok-api), [Amazon](https://everyinfra.com/en/amazon-api) and [more](https://everyinfra.com/en/market) — plus [web search](https://everyinfra.com/en/products/search), [CAPTCHA solving](https://everyinfra.com/en/captcha) and an [OpenAI-compatible AI API](https://everyinfra.com/en/products/ai) that is free after a top-up. This repository packages the agent plugin and the remote MCP connection.

Install one package to give an AI agent reusable EveryInfra workflows **and** the metadata needed
to connect to EveryInfra's remote MCP server. The repository supports Codex, Claude Code, Cursor,
GitHub Copilot-compatible clients, and hosts that implement Agent Plugins 1.0.

This is a plugin repository, not a copy of the EveryInfra backend. It contains:

- 10 discoverable skills: one router, seven product skills, and two outcome workflows;
- remote MCP connection metadata for `https://api.everyinfra.com/mcp`;
- host-specific plugin manifests for Codex, Claude Code, and Cursor;
- self-hosted marketplace manifests for Codex, Claude Code, Cursor, and GitHub Copilot;
- presentation assets and safety boundaries for paid calls, credentials, billing, and external side
  effects.

No API key, customer data, credential, or private gateway source code belongs in this repository.

> **Update (2026-10-09):** the two data cleanup tools have been retired. To clean, classify,
> extract or summarize the data you collect, use the [AI API](https://everyinfra.com/en/products/ai):
> OpenAI-compatible `POST /api/v1/chat/completions`, also available as the MCP tool
> `everyinfra_chat`. It is free for accounts that have topped up, with per-minute limits that follow
> cumulative top-ups. From version 0.3.0 the skills in this package route that work to the AI API.

## MCP or plugin?

| If you need... | Choose | What you get |
| --- | --- | --- |
| Live tools only | MCP | A direct connection to the remote server and its current tool schemas. |
| Reusable routing and task workflows | Plugin | Skills plus host discovery metadata; the package can also declare an MCP connection. |
| Application or CI integration | REST or SDK | Programmatic access that does not depend on an agent host. |
| Catalog discovery and updates | Marketplace | A pointer to the plugin package; a marketplace does not execute tools. |

MCP and plugins are different layers. MCP is the runtime protocol for live tools, resources,
prompts, and server instructions. A plugin is an installable package that can bundle skills, MCP
connection metadata, hooks, UI assets, and host-specific discovery metadata. Either layer can be
used without the other.

### Why a host may show only Skills

Many hosts surface the installed package through its components rather than as one callable
"plugin." Seeing `everyinfra`, `everysearch`, or the other child skills in an agent's skill list is
expected; the plugin remains the installation and update unit. Check the host's plugin list for the
package and its MCP list for the live server connection. A visible skill does not, by itself, prove
that the MCP connection is authenticated or that an official marketplace has listed the package.

See [MCP, plugin, app, and marketplace boundaries](docs/architecture.md) for the full model.

## What agents can use it for

The package is designed to be discovered from either the product name or the requested outcome.
Example requests include:

- "Find current sources for this claim and cross-check them."
- "Discover the right public-data capability, then export a bounded CSV."
- "Search public profiles, posts, comments, listings, or reviews as structured data."
- "Run this text task through EveryAI."
- "Clean and label these collected comments with the AI API, and return JSON."
- "Solve this captcha for a target I am authorized to automate."
- "Inspect available phone-number, transactional-email, or proxy options before I approve an
  order or send."

AI discovery terms include: **EveryInfra, EveryData, EverySearch, EveryAI, EverySolve,
EveryNumber, EveryMail, EveryProxy, MCP, web search, cited research, structured public data,
social data, ecommerce data, bulk export, captcha, phone verification, transactional email, and
proxy API**.

For an AI agent:

1. Use the `everyinfra` router when the user names EveryInfra, needs more than one product, or has
   not chosen a product.
2. Use a product skill directly when the requested outcome is unambiguous.
3. Discover live MCP capabilities and schemas before inventing parameters or estimating cost.
4. Treat purchases, sends, rentals, captcha solves, and credential delivery as explicit external
   actions. A read or draft request is not authorization to execute them.
5. Keep EveryNumber, EveryMail, and EveryProxy on their documented REST paths until live MCP
   discovery proves otherwise.

## Capability matrix

| Product or workflow | Package entry | Runtime path | Typical outcome |
| --- | --- | --- | --- |
| EveryInfra | `everyinfra` | Router | Choose the correct product and execution boundary. |
| EveryData | `everydata` | MCP | Discover and retrieve structured public-platform data. |
| EverySearch | `everysearch` | MCP | Search, read, crawl, and cross-check current public sources. |
| EveryAI | `everyai` | MCP | Run OpenAI-compatible text generation through EveryInfra. |
| EverySolve | `everysolve` | MCP | Handle an authorized captcha or anti-bot challenge. |
| EveryNumber | `everynumber` | REST guidance | Inspect or operate authorized number activation and rental flows. |
| EveryMail | `everymail` | REST guidance | Inspect, draft, schedule, or send transactional email with authorization. |
| EveryProxy | `everyproxy` | REST guidance | Inspect packages, order, and retrieve credentials with authorization. |
| Cross-check research | `everyinfra-crosscheck-research` | MCP workflow | Produce an evidence-backed answer from distinct retrieval paths. |
| Bulk data export | `everyinfra-bulk-data-export` | MCP workflow | Export bounded, deduplicated CSV or JSON with cost controls. |

The live capability catalog and tool schemas are authoritative. The package must not invent an MCP
tool name, current price, availability state, or billing result.

### AI API route

Use the MCP tool `everyinfra_chat`, or REST `POST https://api.everyinfra.com/api/v1/chat/completions`
with any OpenAI SDK (`base_url` = `https://api.everyinfra.com/api/v1`, same API key). It is free for
accounts that have topped up; per-minute limits follow cumulative top-ups (50 under $100, 500 from
$100, 5,000 from $500, all keys combined). It is meant for organizing the data you collect with
EveryInfra.

## Status: what exists today

| Layer | Repository state | What is not implied |
| --- | --- | --- |
| Remote MCP | Production advertises six tools at `https://api.everyinfra.com/mcp`: capability list, data call, AI chat, CAPTCHA types, CAPTCHA solve and web search. | Discovery is not proof that an account is authenticated or has the balance or top-up a call requires. |
| Plugin package | Portable and host-specific manifests, skills, MCP metadata, and assets are present. | Presence is not a clean-host installation test. |
| Repository validator | Cross-host JSON, path, skill, MCP, and credential-safety checks are available. | Repository validation is not marketplace approval. |
| Self-hosted catalogs | Four marketplace manifests are present in this repository. | A catalog file is not an official listing. |
| OpenAI registered app | No `.app.json` or host-issued app ID is included. | Direct MCP metadata is not a registered ChatGPT connector. |
| Official marketplaces | No submission or listing is claimed here. | Prepared metadata is not submitted, approved, or published metadata. |

Release claims should distinguish **prepared**, **validated**, **installed**, **submitted**, and
**listed**. Do not collapse them into one status.

## Quick start

An EveryInfra API key is required for paid operations. Public capability discovery may be available
without one. Keep the key in the installing host's secret or environment configuration—never in a
manifest, prompt, committed file, or URL query string.

```bash
export EVERYINFRA_API_KEY="ei_..."
```

### SDK release attachments for `v0.2.0`

The `v0.2.0` GitHub Release distributes the official Python and Node clients as release attachments.
These URLs are the supported direct-install path for this version; they do not claim that an npm or
PyPI package with the same name has been published.

Python 3.9 or newer:

```bash
python -m pip install \
  https://github.com/everyinfra/everyinfra-agent-plugins/releases/download/v0.2.0/everyinfra-0.2.0-py3-none-any.whl
```

Node.js:

```bash
npm install \
  https://github.com/everyinfra/everyinfra-agent-plugins/releases/download/v0.2.0/everyinfra-0.2.0.tgz
```

### Codex

From a local clone:

```bash
codex plugin marketplace add <path-to-this-repository>
codex plugin add everyinfra@everyinfra
```

Then add an authenticated MCP connection for paid calls:

```bash
codex mcp add everyinfra \
  --url https://api.everyinfra.com/mcp \
  --bearer-token-env-var EVERYINFRA_API_KEY
```

The explicit MCP entry is separate because a distributable plugin must not contain a real bearer
token. Restart with a new task after installing so Codex can discover the ne