API 文档

EveryInfra API 与 MCP 开发文档

EveryInfra 提供数据采集、联网搜索、验证码识别与绑定本人 EveryData 来源的数据清洗。MCP 是调用这些能力的协议入口。普通 API 使用对应 Key 权限和钱包；清洗还需独立 scope 与账户权益。

我们提供什么

怎么选择入口

快速开始

使用有效邀请码注册可获得 $1 测试额度(≈720 次数据调用)；普通注册不自动赠送额度。可加微信获取邀请码。拿到 API Key 后，先选择你要调用的入口；下面以统一数据 API 为例：

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"xiaohongshu","action":"search",
       "params":{"keyword":"露营","limit":20}}'

{
  "platform": "xiaohongshu",
  "action": "search",
  "count": 20,
  "results": [ { "id": "...", "title": "...", "like_count": 3280 } ],
  "quota": { "remaining_cny": 47.5, "remaining_credits": 470000 }
}

鉴权

每个请求带上 Authorization 头，值为 Bearer <你的 API Key>。API Key 在 控制台 创建，完整 Key 仅在创建时显示一次。Base URL:https://api.everyinfra.com。

统一数据 API

一个端点通吃全部数据能力。请求体三要素:platform(平台标识，如 xiaohongshu / google_maps_reviews / amazon)、action(动作，如 search / user_posts / reviews / comments)、params(动作参数，如 keyword / url / limit)。换平台只换 platform 字段，响应结构统一。

支持的平台与能力

89 平台 / 405 能力，三大域:社交内容(小红书、抖音、Instagram、X、TikTok、YouTube、微博、知乎、公众号、B站、Reddit 等)、点评口碑(谷歌地图、TripAdvisor、Yelp、Trustpilot、Glassdoor、App Store、Google Play 等，按 URL/域名取评论)、电商(Amazon、速卖通、eBay、Etsy、Temu 等)+ 全网搜索。完整清单看 GET /api/v1/social/catalog(免费，不计费；含每个能力的必填/可选参数、单次条数上限和单价)。还覆盖招聘、设计社区与房产等任务，具体支持范围以能力目录为准。

异步任务

异步动作包括 Facebook 主页/帖子/评论、Instagram 用户帖子/发现和 LinkedIn 评论。提交后立即返回 job_id，用 GET /api/v1/jobs/{job_id} 轮询，完成后取结果。只在提交时计费一次，轮询免费。

搜索 API（EverySearch）

一个端点 POST /api/v1/search，17 个工具，请求体用 tool 选：网页 / 语义 / 深度检索 / 学术与专利 / 新闻 / 商品 / 地点 / 图像与视频 / 反向图搜 / 论坛 / 正文抓取 / 整站爬取 / 站点结构 / 相似页面 / 联想词 / 交叉验证 / 长任务抓取。工具目录 GET /api/v1/search/tools 不鉴权、免费，带每个工具的参数与单价。

三档基础标价：标准 $0.69 / 千次 / 深度 $1.39 / 千次 / 交叉验证 $2.78 / 千次。选择前请查看工具目录列出的参数、返回格式与当前价格；实扣金额在调用响应中核对。

curl -X POST https://api.everyinfra.com/api/v1/search \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"web","query":"EU AI Act 合规要求","num":10}'

验证码识别 API（EverySolve）

一个端点 POST /api/v1/captcha，53 种类型，$0.14 / 千次–$4.58 / 千次。请求体第一个字段永远是 type，其余参数逐类型不同。能力目录 GET /api/v1/captcha/types 不鉴权、免费，带每种类型的必填/可选参数、解的形状和单价 —— 而且带 available 字段如实反映此刻能不能卖，别把它缓存起来当静态数据用。

仅成功计费；失败不产生最终扣款：未取得有效解、执行失败或超时，若已预扣则余额自动恢复。

curl -X POST https://api.everyinfra.com/api/v1/captcha \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"turnstile",
       "website_url":"https://example.com/login",
       "website_key":"0x4AAAAAAA..."}'

{
  "type": "turnstile",
  "solution": { "token": "0.aBcD..." },
  "token": "0.aBcD...",          // 标量解额外给一个顶层字段，省一层取值
  "billing": { "charged": true, "credits": 20, "cny": 0.002 }
}

⚠ 解的形状有 8 种，接入前先确认你这一类是哪种。 这是这条 API 最容易写错的地方：不同验证码交付的东西根本不是一类东西，有的是一个字符串填回表单，有的是一组坐标要你自己去点。solution 里的字段名以目录返回的 solution.keys 为准。

前四种是单个标量，响应会额外给一个顶层 token 字段，省掉一层取值；后三种不是标量，没有顶层 token，只能从 solution 里取。坐标和矩形的数值一律是数字、键名一律 snake_case。

有几类要你自带代理（目录里 proxy 在必填里的那些）：它们交付的是 Cookie 而不是 token，而 Cookie 绑定求解时的出口 IP —— 用我们的出口解出来，你拿去用是无效的。所以代理必须是你后续请求要用的那个出口。

权益内免费 AI 数据清洗

净实收累计充值达到 ¥500 的直客，可明确领取首期 30 天权益，在额度内用 Gemini 清洗本人仍可读取的 EveryData 采集结果。清洗不另收费，采集仍按原价计费；不是无限免费聊天接口。

账户所有 Key 合计 5 次提交/分钟、最多 5 个并发单元，每日 1,000 个成功单元、首期共 30,000 个。查询资格不开始周期；关联结算记录调整后会重核资格，恢复不重开周期。

先在客户控制台清洗工作区核对资格并给 Key 显式授权 data/data_cleanup。旧的 all/data 宽权限不会自动授权数据外发。固定配方只接收来源引用、版本和所选字段，不接任意 prompt、URL 或自由模型选择。

顺序：读取资格 → 明确领取 → 读取本人来源与字段结构 → 选择固定配方并预估 → 确认所选字段将交给 Gemini 处理 → 带原操作号提交 → 查询任务、对照结果、导出或删除。

首次提交前持久保存 Idempotency-Key，它只放请求头，不放 URL、日志或埋点。网络中断时用原号调用 GET /api/v1/data-cleanup/jobs/by-idempotency-key；404 不能证明从未受理，不换号盲重发。任务列表按 next_cursor 手动翻页，游标失效回到首页，列表不是数据库快照。

字段接口返回当前来源的有界推断，不含样例值；类型不是平台保证，仍以 preview 校验为准。源版本变化返回 409，源或结果到期返回 410。未知结果不自动重发；失败或空结果不占成功额度。

结果不延长原来源的保留期；不完整导出须先查看缺失数量并明确接受 partial。删除结果正文后不能再读出，但无正文的执行元数据在任务终结后保留 90 天；删除不代表收回已下载副本。模型结果可能有误，重要结论应对照来源复核。

REST、MCP 和 Python/Node SDK 共用同一契约。MCP 先发现清洗 read/action 工具；SDK 的清洗方法不自动重试。完整请求字段、错误和 scope 见OpenAPI。

通用文本 API 状态与迁移

通用文本 API 已退出，历史调用返回 410 ai_chat_retired；旧 Key 和账单保留。请改用绑定本人 EveryData 来源的数据清洗。

MCP 接入

支持 MCP 的客户端可通过 POST https://api.everyinfra.com/mcp（Streamable HTTP）发现并调用 EveryInfra 工具，无需在本地运行服务器。先读取 tools/list 和每个工具的 inputSchema，再选择参数；插件安装成功、Skill 可见或目录有商品，都不等于当前 Key 已有付费权限或商品有库存。

通过 everyinfra_list_capabilities 发现数据能力，使用 everyinfra_call_api 和 everyinfra_search 调用数据与搜索产品。验证码先用免费的 everyinfra_list_captcha_types 核对 type、必填参数、解的形状和实时可用性，再调用 everyinfra_solve_captcha；目录查询不计费。清洗请先发现其 read/action 工具并核对独立 scope；实际工具与参数以 tools/list 为准。

通过客户端的密钥配置注入 Authorization: Bearer <API Key>，不要把真实 Key 放进对话、代码仓、截图或 URL。旧连接器的查询参数鉴权仍兼容，但 URL 容易进入历史与日志，不用于新接入。客户端是否支持远程 MCP、自定义鉴权或插件需分别核对；直接连接 MCP 不等于安装插件，也不等于官方市场已上架。

HTTP 200 不等于工具调用成功：先检查 JSON-RPC error，再检查 result.isError 与业务状态。文本模型的首个文本块是回答，不要假定所有文本块都是 JSON；若返回额外的账单 JSON，读取其中的 billing。同一结果同时出现在 structuredContent 和 JSON 文本时只消费一份；没有账单信息不能推断为免费。

EveryMail、EveryNumber、EveryProxy 的资源 MCP 尚未默认开放，现有接入继续走 REST。即使目标服务显式开放资源工具，也必须先核对 schema，再对发送对象、采购数量或租期、美元预算取得具体确认。查短信验证码或取代理凭据可能扣费，不能当作免费状态查询；超时或结果不明时保留原幂等键、Key 和参数，核查已有订单，不自动换键、重发或转 REST 再执行。

首页接入示例与控制台「MCP 接入」页帮助配置连接；最新能力说明见 llms.txt 和 OpenAPI。连接、鉴权、实际调用和对外发布分别验收，不用其中一步替代其余步骤。

错误码

下表说明数据、搜索、文本与验证码 REST 调用的常见错误。MCP 还需检查工具结果；邮件、号码和代理的外部动作不适用“报错就直接重试”，应先核订单状态与账单。

计费

一个钱包跨服务扣费:数据/搜索按平台分4档 $0.56 / 千次–$5.56 / 千次(对标档 $0.56 / 千次 / 标准档 $1.39 / 千次 / 深度档 $2.78 / 千次 / 高难档 $5.56 / 千次)；权益额度内的数据清洗不另收费，采集照常计费；失败或空响应不计费，余额长期有效。

直客使用同一条折扣阶梯，可由累计充值额度或当日已完成计费的请求量达成，服务端取其中更优的一档，折扣不叠加。KyrenPay 订单只有在 EveryInfra 内部状态显示余额已到账（credited）后才计入累计充值；赠送额度不计入。请查看控制台当前账户状态，实际扣费以调用返回的 billing 为准，不在客户端自行换算、乘折扣或叠加优惠。公开计费单位与标准价格见定价页。

每次付费调用的响应里都带 billing 字段，写明本次实际扣了多少与计价依据，不用回查账单就能对账:

"billing": {
  "charged": true,              // 本次是否真的扣费（空结果/失败为 false）
  "credits": 400,               // 实扣 credits
  "cny": 0.04,                  // 实扣金额
  "list_price_credits": 400,    // 该能力的标价（未折、未乘目标数）
  "tier_credits": 400,          // 平台档单价
  "discount_rate": 0.9,         // 生效折扣（无折扣时不出现）
  "units": 20                   // 扇出能力按目标数计费时出现
}

扇出能力(一次传多个 URL)按实际成功的目标数计费:部分目标没采到时响应带 partial: true 与 missed 列表，没采到的那几个不收钱。