Документация по API и MCP EveryInfra

Для вызова API EveryInfra прокси не нужен. Запрос отправляется напрямую на api.everyinfra.com, а в ответ приходит JSON с именованными полями. С собственными программами всё иначе: если вашему краулеру или средству автоматизации браузера нужно открыть страницу так, как её видит пользователь из определённой страны, потребуется выходной IP-адрес в этой стране.

Всё просто: IPFoxy предоставляет вашим запросам другой выходной IP-адрес, а EveryInfra — структурированные данные для платформ из своего каталога.

Этот пример на Python выполняет оба шага в одном скрипте. На шаге 1 скрипт обращается к ipinfo.io через выходной IP-адрес IPFoxy и выводит страну этого IP-адреса. На шаге 2 он напрямую обращается к EveryInfra за данными об одном товаре Amazon. Перед запуском задайте две переменные окружения: EVERYINFRA_API_KEY — ваш API-ключ, а IPFOXY_PROXY — строка подключения из панели управления IPFoxy в формате http://username:password@host:port. Установите requests командой pip install requests.

import os

import requests

EVERYINFRA_API_KEY = os.environ["EVERYINFRA_API_KEY"]
IPFOXY_PROXY = os.environ["IPFOXY_PROXY"]  # http://username:password@host:port
PROXIES = {"http": IPFOXY_PROXY, "https": IPFOXY_PROXY}

# 1. Ваш собственный запрос идёт через выходной IP IPFoxy.
exit_ip = requests.get("https://ipinfo.io/json", proxies=PROXIES, timeout=30).json()
print("Exit IP country:", 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("Charged USD:", body["billing"]["charged_usd"])

• direct.trust_env = False заставляет вызов EveryInfra игнорировать переменные окружения HTTP_PROXY и HTTPS_PROXY. Без этого через общесистемный прокси пойдёт и этот вызов, и вы заплатите за его прокси-трафик.
• Ответ 407 от прокси означает неверное имя пользователя или пароль. Пример останавливается до вызова EveryInfra, поэтому ничего не списывается. В справочном центре IPFoxy указано, что прокси работает, только если код запускается из сети за пределами материкового Китая.
• Мы запустили этот код 24 октября 2026 года. Вызов EveryInfra вернул название, цену и рейтинг товара, списано $0,001389. Аккаунта IPFoxy у нас нет, поэтому шаг с прокси мы проверили на локальном мок-прокси: формат адреса, туннель CONNECT и случай с ошибкой 407.
• Сколько прокси-трафика расходует одна страница: около 0,44 МБ, если загружать только HTML, и около 7,96 МБ при полной загрузке в браузере. Стоимость за 1000 страниц на каждом тарифе IPFoxy с учётом нужной вам доли успешных запросов смотрите в статье Сколько прокси-трафика расходует одна страница Amazon?».
• Полный пример, локальный мок-прокси и скрипт для подсчёта байтов лежат на GitHub: everyinfra-agent-plugins / examples / proxy-plus-data-api.

Exa ищет в интернете по смыслу. Запрос не обязан содержать слова со страницы: Exa всё равно находит нужные компании, статьи и научные работы и возвращает их текст вместе с результатами. EveryInfra даёт структурированные данные платформ, например рейтинги и отзывы с G2 и Trustpilot или комментарии YouTube, в виде JSON с именованными полями.

Типичная схема: с помощью Exa составить список объектов, а затем с помощью EveryInfra добавить к каждому из них данные платформ.

Этот пример на Python составляет таблицу отзывов о конкурентах. Шаг 1 запрашивает у Exa «note-taking apps similar to Obsidian»; благодаря category: "company" в ответ попадают только главные страницы компаний. Шаг 2 вызывает API EveryInfra g2/search для каждой компании и получает её рейтинг и число отзывов на G2. Перед запуском задайте две переменные окружения: EXA_API_KEY — ваш ключ из панели Exa, EVERYINFRA_API_KEY — ваш API-ключ EveryInfra. Нужна библиотека requests: pip install requests.

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']} reviews")
    else:
        print(f"{name:12} {domain:16} no G2 reviews yet")
print("EveryInfra charged (USD):", round(spent, 6))

• Мы запустили этот код без изменений 25 октября 2026 года. Exa вернул 10 главных страниц компаний, а при повторном поиске через несколько минут — те же 10. У 7 из 10 есть рейтинги и отзывы на G2, например у Goodnotes 4,7 при 123 отзывах, у Milanote 4,5 при 42. Мы по одному разу запустили английскую, китайскую и испанскую версии; каждый запуск занял 44–51 секунду. EveryInfra списала $0,01389 (10 вызовов g2/search); поиск в Exa стоил $0,007.
• Компания считается найденной, только если её название полностью совпадает с названием продукта на G2. Пример берёт заголовок результата Exa и отбрасывает всё после « - ». В нашем запуске на G2 не нашлось продукта Brainio, а у Yaranga и Brainfo есть страницы на G2, но пока нет отзывов.
• Каждый вызов g2/search оплачивается один раз ($0,001389), даже если продукта с таким названием нет, потому что API всё равно возвращает результаты поиска. Один вызов занимает около 30–70 секунд, поэтому пример выполняет по 4 вызова одновременно.
• Для Trustpilot замените шаг 2 на trustpilot/profile и передайте домен компании в company. Из тех же компаний профиль на Trustpilot нашёлся у 4 из 7. Для компании без профиля возвращается пустой результат, и он не оплачивается.
• В результатах Exa нет веток Reddit: с includeDomains, равным reddit.com, он вернул 0 результатов, и запрос ничего не стоил.
• Подробнее об охвате 3 категорий и 30 компаний, о крупных компаниях, пропущенных при точном сопоставлении названий, и о полном наборе данных читайте в статье « Exa находит конкурентов, EveryInfra проверяет их отзывы».

Monid — маршрутизатор инструментов для ИИ-агентов. Агент одним предложением описывает, что ему нужно: discover бесплатно возвращает подходящие эндпоинты и их цены, inspect так же бесплатно возвращает схему входных данных и текущую цену, а оплачивается только run: сумма по этой цене списывается с единого предоплаченного баланса. EveryInfra предоставляет API данных платформ с фиксированной структурой: единый формат запроса, а для каждой возможности — фиксированные имена полей и фиксированная цена.

Обычно задачи разделяют по тому, насколько часто повторяется вызов. Платформы из каталога EveryInfra (106 на 3 ноября 2026 года; актуальный список возвращает GET /api/v1/social/catalog) отправляются в EveryInfra. Платформы вне каталога и инструменты, которые вообще не относятся к данным (погода, геокодирование, логотипы компаний, генерация изображений), отправляются в Monid.

Этот пример на Python объединяет оба типа вызовов в одном скрипте. Шаг 1 — ежедневная задача: скрипт вызывает EveryInfra xiaohongshu/search по запросу «matcha latte» с сортировкой по числу лайков и выводит первые 3 заметки и сумму списания. Шаг 2 — разовая задача: Monid находит инструмент, который возвращает логотип компании по домену, и скрипт запускает его, только если цена из inspect не превышает MAX_PRICE_USD. Перед запуском задайте две переменные окружения: EVERYINFRA_API_KEY — ваш API-ключ EveryInfra, MONID_API_KEY — API-ключ, созданный в панели Monid (app.monid.ai). Нужна библиотека requests: pip install requests.

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": "matcha latte", "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"))

• Мы запустили этот код без изменений 3 ноября 2026 года в 16:45 (по сингапурскому времени). EveryInfra вернула 20 заметок и списала $0,005556. Monid discover поставил эндпоинт для логотипов компаний на первое место, inspect показал $0 за вызов, а run вернул статус COMPLETED и URL изображения логотипа. Скрипт отработал за 6–7 секунд. Мы по одному разу запустили китайскую, английскую и испанскую версии (китайская версия ищет по китайскому названию напитка).
• Каждый вызов xiaohongshu/search возвращает одну страницу с максимум 20 заметками и стоит $0,005556. Страница без заметок не оплачивается. Для следующей страницы передайте next_page_token из результатов.
• Monid не берёт плату за discover и inspect; оплачивается только run по цене, которую показывает inspect. Пока выполняется запуск, Monid резервирует на балансе расчётную стоимость и списывает фактическую сумму по его завершении (Monid llms.txt, прочитано 03.11.2026). В примере MAX_PRICE_USD используется, чтобы пропускать инструменты, стоимость которых превышает ваш бюджет.
• Агенту можно задать правило маршрутизации, например такое: «Платформы из GET https://api.everyinfra.com/api/v1/social/catalog отправляйте в everyinfra_call_api. Все остальные платформы и инструменты обрабатывайте через Monid: discover, затем inspect, и run, только если цена укладывается в бюджет. Записывайте в лог сумму списания каждого вызова».
• MCP-сервер Monid (https://mcp.monid.ai/v1) требует входа через OAuth в браузере; мы его не тестировали. Шаги настройки для Claude, Claude Code, Codex, OpenCode и ChatGPT описаны в руководстве [«Быстрый старт с MCP-сервером Monid»](https://monid.ai/docs/guide/quickstart-mcp). Настройка на стороне EveryInfra описана в разделе о MCP выше.