API 文档

EveryInfra API 与 MCP 开发文档

EveryInfra 提供数据采集、联网搜索、验证码识别，以及充值用户免费使用的 AI 接口（兼容 OpenAI）。MCP 是调用这些能力的协议入口。所有接口用同一把 API Key 和同一个钱包。

我们提供什么

怎么选择入口

快速开始

在 GitHub 给两个仓库点星领 $1 额度(≈720 次数据调用)：给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星，注册后在控制台「余额与充值」领取，领取后 24 小时内有效，不能用于验证码识别。拿到 API Key 后，先选择你要调用的入口；下面以统一数据 API 为例：

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_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 } ],
  "billing": { "charged": true, "charged_usd": 0.005556, "balance_after_usd": 12.340122 }
}

鉴权

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

用同一把 Key 调 GET /api/v1/account 可以查余额（付费、赠送与合计）、本月折扣档、每分钟次数上限和近 24 小时用量。金额都是美元；这个接口只读、不计费，也不占每分钟次数。

curl https://api.everyinfra.com/api/v1/account \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY"

要读全账户范围的记录（每日用量、调用记录、账单、钱包流水），同一把 Key 可以调控制台接口，例如 GET /portal/api/requests/{request_id}，按接口看成功率和耗时用 GET /portal/api/quality；它们需要 Key 有账户读取权限，不扣费，每账户每分钟 60 次，完整列表见 OpenAPI 的 Account 一节。

不想轮询的话，在控制台「设置 → Webhook」填一个 HTTPS 地址：余额降到你设的阈值、或异步任务结束时，我们发一个带签名的 POST。签名在 X-EveryInfra-Signature 请求头里，是用签名密钥对「时间戳、英文句点、原始请求体」算的 HMAC-SHA256；时间戳相差超过 5 分钟的请求请直接拒绝，并按事件 ID 去重（失败会退避重试，最多 7 次）。

要让 AI 也能改账户，在「API Keys → 权限限制」里给它打开写权限：管理 Key、修改设置、开工单和回复，三项都默认关闭、只能由你登录控制台勾选。经 Key 新建 Key 每天最多 20 把，开工单不限张数；查看或轮换完整 Key、改权限和 IP 白名单、重新启用 Key、付款，永远只能在控制台做。完整接口见 OpenAPI 的 Account 一节，例如 POST /portal/api/keys/{key_id}/disable。

balance.total_usd 是付费余额加赠送余额的合计，扣费时先用赠送余额；bonus_expiring 列出还没到期的限时赠送额度；discount 是本月充值折扣档和距下一档还差多少（经服务商开通的账户价格由服务商套餐决定，这里为 null）；rate_limit.requests_per_minute 是账户名下所有 Key 合计的每分钟次数上限（AI 接口另有分档）；usage_24h 是近 24 小时的调用数和实际花费，可能有约 1 分钟延迟。

统一数据 API

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

支持的平台与能力

106 平台 / 573 能力，三大域:社交内容(小红书、抖音、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} 轮询，完成后取结果。只在提交时计费一次，轮询免费。

任何数据能力都可以在请求体加 "mode": "async" 改走异步。一次要跑几十上百个请求时请用异步：同步调用要在 85 秒内返回，超过就按超时失败（不计费）；异步提交后立即拿到 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 $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"web","q":"EU AI Act 合规要求","num":10}'

验证码识别 API（EverySolve）

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

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

curl -X POST https://api.everyinfra.com/api/v1/captcha \
  -H "Authorization: Bearer $EVERYINFRA_API_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, "charged_usd": 0.001528, "balance_after_usd": 12.345122 }
}

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

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

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

AI 接口（充值用户免费）

AI 接口兼容 OpenAI 的 chat/completions：充值过任意金额的账户免费调用，不扣余额，用来清洗、去重、分类、抽取和总结你在万有引擎采集的数据，输出格式由你在提示词里定。

用 OpenAI SDK 时把 base_url 设成 https://api.everyinfra.com/api/v1，api_key 填 EveryInfra 的 API Key（和其他接口同一把，放在 Authorization: Bearer 请求头里；网址里带 ?key= 会被拒绝）。对话接口是 POST /api/v1/chat/completions，请求和返回格式与 OpenAI 一致。

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.everyinfra.com/api/v1",
    api_key=os.environ["EVERYINFRA_API_KEY"],
)
r = client.chat.completions.create(
    model="gemini-3.6-flash",
    messages=[{
        "role": "user",
        "content": "只返回 JSON:给这条评论标注 sentiment、topic 和 intent",
    }],
)
print(r.choices[0].message.content)

模型有两个：默认的 gemini-3.6-flash，和更轻量的 gemini-flash-lite。GET /api/v1/models 返回同样的清单，这个接口不用 Key。model 写错会返回 422，并提示可能的正确名称。

按累计充值分档限速，账户内所有 Key 合计：

单笔超过 $1 的额度码和赠送额度也和充值一样算，试用额度和 $1 及以下的不算。没充值过、也没有过单笔超过 $1 的额度码或赠送额度的账户，调用返回 403 ai_topup_required。分档是上限。

支持流式：请求里加 stream: true，按 SSE 逐段返回，以 data: [DONE] 结束；需要用量时加 stream_options.include_usage。

messages 合计最多 45,000 字符，超过返回 422 input_too_large，请切块后分多次请求。多轮对话由每次请求带上完整历史实现；不要依赖图片、PDF、音频或视频输入。

AI 接口用来整理你在万有引擎采集的数据。如果用在别的地方，或者调用明显异常，我们可能会暂停这个账号的 AI 接口；账号本身、其他接口和余额都不受影响。

批量与并发

批量处理时限制同时发出的请求数，不要超过你这一档的「同时在跑」上限；遇到 429 按 Retry-After 等待，遇到 503 做带抖动的指数退避。每条任务保留自己的业务 ID，便于重试和对账；先让模型只返回固定 JSON，再在客户端校验失败的条目。

import os
from concurrent.futures import ThreadPoolExecutor
from openai import OpenAI

client = OpenAI(base_url="https://api.everyinfra.com/api/v1", api_key=os.environ["EVERYINFRA_API_KEY"])
comments = ["物流很快，包装也很好", "功能一般，价格偏高"]

def label(text: str):
    return client.chat.completions.create(
        model="gemini-3.6-flash",
        messages=[{"role": "user", "content": f"只返回 JSON，字段为 sentiment/topic/intent：{text}"}],
    ).choices[0].message.content

# 并发数不要超过你这一档的「同时在跑」上限
with ThreadPoolExecutor(max_workers=5) as pool:
    results = list(pool.map(label, comments))

MCP 接入

支持 MCP 的客户端可通过 POST https://api.everyinfra.com/mcp（Streamable HTTP）发现并调用 EveryInfra 工具，无需在本地运行服务器。先读取 tools/list 和每个工具的 inputSchema，再选择参数。插件装好、能看到 Skill 或工具，不代表这把 Key 已经能付费调用；目录里有商品，也不代表商品有货。

MCP 有两个入口，用同一把 Key：https://api.everyinfra.com/mcp 只列 12 个常用工具（采集、搜索、验证码、AI 接口，加查余额、查调用记录、拿充值链接、开工单和查工单）；https://api.everyinfra.com/mcp/all 列全部 24 个，下面的账户记录和管理工具只在它的列表里。账户类工具改成了动词在前的名字（例如 everyinfra_account 改成了 everyinfra_get_account），旧名在两个入口上照样能调，只是不再列出：写死旧名的脚本不用改，要在 AI 客户端里用这些工具，把连接器地址换成 /mcp/all。

通过 everyinfra_list_capabilities 发现数据能力，使用 everyinfra_call_api（异步提交的任务用 everyinfra_get_job 免费取结果）和 everyinfra_search 调用数据与搜索产品。验证码先用免费的 everyinfra_list_captcha_types 核对 type、必填参数、解的形状和实时可用性，再调用 everyinfra_solve_captcha；目录查询不计费。实际工具与参数以 tools/list 为准。AI 对话用 everyinfra_chat（充值用户免费，非流式）。查余额、本月折扣档和每分钟次数用免费的 everyinfra_get_account（无参数，返回内容与 GET /api/v1/account 相同）。

更细的账户记录用这几个免费工具读：everyinfra_get_usage、everyinfra_list_requests、everyinfra_get_billing、everyinfra_list_keys、everyinfra_list_tickets，分别是每日用量、调用记录（按 request_id 查单次调用的最终扣费结算）、账单与钱包流水、Key 列表和人工客服工单列表。它们要求这把 Key 有对应的账户读取权限：没限产品的 Key 默认能读用量、调用记录和账单；限了产品的 Key，以及工单读取，要在控制台「API Keys → 权限限制」里打开。要充值时用 everyinfra_get_topup_link 拿控制台充值页链接，由账户主人自己付款，工具本身不会建单或扣款。

调用一直失败、数据不对、充值或扣费有疑问、想要新平台或字段时，任何一把 Key 都能用 everyinfra_create_ticket 开人工客服工单（免费、不需要额外权限），返回工单号和控制台链接，之后用 everyinfra_get_ticket 查进度和客服回复；REST 是 POST /api/v1/support/tickets 和 GET /api/v1/support/tickets/{ticket_id}。旧的开单工具 everyinfra_ticket_create（要写权限）仍可用，新接入请用 everyinfra_create_ticket。

账户主人在控制台给 Key 打开写权限之后，AI 还可以用这几个工具改账户：everyinfra_create_key、everyinfra_update_key、everyinfra_disable_key、everyinfra_delete_key、everyinfra_update_settings、everyinfra_set_webhook、everyinfra_test_webhook、everyinfra_reply_ticket（分别是新建、修改、停用、删除 Key，改设置，设置和测试 Webhook，回复工单）。写权限默认关闭，只能由人登录控制台勾选；经 Key 新建的 Key 不会比发起的那把更宽，也永远不带写权限；人建的 Key 只能停用。AI 做的每一项修改都会出现在控制台「消息」里。

通过客户端的密钥配置注入 Authorization: Bearer <API Key>，不要把真实 Key 放进对话、代码仓、截图或 URL。网址里带 Key 的旧连接（?key=）2026-11-04 起已经停用，会回 401；只能填网址、不能设请求头的客户端，改接 /mcp/all 并按提示登录。各个客户端是否支持远程 MCP、自定义请求头或插件，要分别确认；直接连 MCP 和安装插件是两回事。

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

邮件、接码和 IP 代理（EveryMail、EveryNumber、EveryProxy）暂时不能通过 MCP 默认调用，请继续用 REST。以后开放时，也要先看清工具参数，再让用户确认发给谁、买多少或租多久、预算多少美元。查短信验证码或取代理账号可能扣费，不是免费的状态查询；超时或结果不明时保留原幂等键、Key 和参数，先查已有订单，不要自动换键、重发或改用 REST 再发一次。

首页接入示例与控制台「MCP 接入」页帮助配置连接；最新能力说明见 llms.txt 和 OpenAPI。连上服务器、鉴权通过、调用成功是三件事，接入时请分别确认。

配合 IPFoxy 代理使用

import os

import requests

EVERYINFRA_API_KEY = os.environ["EVERYINFRA_API_KEY"]
IPFOXY_PROXY = os.environ["IPFOXY_PROXY"]  # http://用户名:密码@主机:端口
PROXIES = {"http": IPFOXY_PROXY, "https": IPFOXY_PROXY}

# 1. 你自己的请求：经 IPFoxy 出口
exit_ip = requests.get("https://ipinfo.io/json", proxies=PROXIES, timeout=30).json()
print("出口 IP 所在国家：", exit_ip.get("country"))

# 2. 调 EveryInfra：直连，不需要代理
direct = requests.Session()
direct.trust_env = False  # 忽略 HTTP(S)_PROXY 环境变量，这一步不花代理流量
resp = direct.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {EVERYINFRA_API_KEY}"},
    json={
        "platform": "amazon",
        "action": "profile",
        "params": {"url": "https://www.amazon.com/dp/B0CYJDVT31"},
    },
    timeout=120,
)
resp.raise_for_status()
body = resp.json()
item = body["results"]
print(item["title"][:60], item["currency"], item["price"], item["rating"])
print("本次扣费（美元）：", body["billing"]["charged_usd"])

配合 Exa 搜索使用

import os
from concurrent.futures import ThreadPoolExecutor
from urllib.parse import urlsplit

import requests

EXA_API_KEY = os.environ["EXA_API_KEY"]
EVERYINFRA_API_KEY = os.environ["EVERYINFRA_API_KEY"]
QUESTION = "note-taking apps similar to Obsidian"

# 1. Exa：按意思找公司，不靠关键词
companies = requests.post(
    "https://api.exa.ai/search",
    headers={"x-api-key": EXA_API_KEY},
    json={"query": QUESTION, "category": "company", "type": "auto", "numResults": 10},
    timeout=60,
).json()["results"]


# 2. EveryInfra：每家在 G2 上的评分和评论数
def g2_rating(company):
    name = company["title"].split(" - ")[0].split(" | ")[0].strip()
    resp = requests.post(
        "https://api.everyinfra.com/api/v1/social",
        headers={"Authorization": f"Bearer {EVERYINFRA_API_KEY}"},
        json={"platform": "g2", "action": "search", "params": {"keyword": name}},
        timeout=180,
    )
    resp.raise_for_status()
    body = resp.json()
    match = next((p for p in body["results"] if p["product_name"].lower() == name.lower()), None)
    return name, match, body["billing"]["charged_usd"]


with ThreadPoolExecutor(max_workers=4) as pool:
    rows = list(pool.map(g2_rating, companies))

spent = 0.0
for company, (name, g2, charged) in zip(companies, rows):
    spent += charged
    domain = urlsplit(company["url"]).hostname.removeprefix("www.")
    if g2 and g2["review_count"]:
        print(f"{name:12} {domain:16} G2 {g2['rating']} / 5 · {g2['review_count']} 条评论")
    else:
        print(f"{name:12} {domain:16} G2 上还没有评论")
print("EveryInfra 本次扣费（美元）：", round(spent, 6))

配合 Monid 使用

import os

import requests

EVERYINFRA_API_KEY = os.environ["EVERYINFRA_API_KEY"]
MONID_API_KEY = os.environ["MONID_API_KEY"]
MONID = "https://api.monid.ai/v1"
MONID_HEADERS = {"Authorization": f"Bearer {MONID_API_KEY}"}
MAX_PRICE_USD = 0.01  # do not run a Monid tool that costs more than this per call

# 1. The daily job: EveryInfra xiaohongshu/search, one fixed request shape
resp = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {EVERYINFRA_API_KEY}"},
    json={"platform": "xiaohongshu", "action": "search",
          "params": {"keyword": "抹茶拿铁", "sort": "most_liked"}},
    timeout=120,
)
resp.raise_for_status()
body = resp.json()
for note in body["results"][:3]:
    print(note["like_count"], note["collect_count"], note["posted_at"][:10], note["url"])
print("EveryInfra:", len(body["results"]), "notes, charged (USD):", body["billing"]["charged_usd"])

# 2. A one-off lookup that is not a daily platform: discover, inspect, run on Monid
found = requests.post(f"{MONID}/discover", headers=MONID_HEADERS, timeout=60,
                      json={"query": "company logo image URL from a domain", "limit": 3}).json()["results"]
# discover adds ranking and price fields to each result; inspect and run take only the fields that name the tool
SHOWN_ONLY = ("providerName", "description", "price", "score", "scoreBreakdown", "tags", "metrics", "hints")
tool = {key: value for key, value in found[0].items() if key not in SHOWN_ONLY}
detail = requests.post(f"{MONID}/inspect", headers=MONID_HEADERS, timeout=60, json=tool).json()
price = detail["price"]["amount"]["value"]
print("Monid tool:", detail["endpoint"], "price (USD):", price)
if price <= MAX_PRICE_USD:
    run = requests.post(f"{MONID}/run", headers=MONID_HEADERS, timeout=120,
                        json={**tool, "input": {"pathParams": {"company": "starbucks.com"}}}).json()
    print("Monid run:", run.get("runId"), run.get("status"), run.get("output"))

错误码

下表说明数据、搜索、AI 接口与验证码 REST 调用的常见错误。每个错误还写明是谁那边的问题、下一步怎么做：fault（request 请求要改、account 账户要处理、service 我们这边）、retryable 和 next_steps；我们这边的问题在重试用完以后会带 support（工单草稿），开单前先问用户。MCP 还需检查工具结果；邮件、号码和代理的外部动作不适用“报错就直接重试”，应先核订单状态与账单。

计费

一个钱包跨服务扣费：平台数据每项能力单独标价，每千次 $0.56 起，单价见各平台页和能力目录；AI 接口对充值用户免费；失败或空响应不计费，充值余额长期有效。

直接在 EveryInfra 注册的账户享受月度充值折扣：按北京时间自然月累计当月已到账的充值面额（不含付款手续费），达档后从下一次调用起按该档计费，每月 1 日重新累计；各档门槛以控制台「账户方案」显示为准。充值要等余额到账（credited）后才计入当月充值累计；单笔超过 $1 的额度码和赠送额度也计入，试用额度和 $1 及以下的不计入。当前折扣档在控制台查看，实际扣费以调用返回的 billing 为准，不在客户端自行换算、乘折扣或叠加优惠。公开计费单位与标准价格见定价页。

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

"billing": {
  "charged": true,                // 本次是否真的扣费（空结果/失败为 false）
  "charged_usd": 0.005556,        // 本次实扣（美元）；没扣为 0，结果未知为 null
  "balance_after_usd": 12.340122, // 本次结算后的钱包余额（美元）；读不到时为 null
  "discount_rate": 0.9,           // 生效折扣（无折扣时不出现）
  "units": 20,                    // 一次传多个目标、按目标数计费时出现
  // 以下为兼容保留的旧字段，对账与展示请用上面的美元字段
  "credits": 400,
  "cny": 0.04,
  "list_price_credits": 400,      // 该能力的标价（未折、未乘目标数）
  "tier_credits": 400             // 平台档单价
}

charged_usd 是本次实扣的美元金额（没扣费为 0，结果还不确定时为 null）；balance_after_usd 是本次结算后的钱包余额（读不到时为 null），跑批量时直接读它就能盯住余额。调用失败、预扣已退回时，错误体里的 billing 也带这个字段。需要完整的余额、折扣档和每分钟次数时调 GET /api/v1/account。

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