AI агенты

MCP сервер

Parser API предоставляет MCP (Model Context Protocol) сервер через HTTP. Подключите Claude, Cursor, VS Code, Codex или любой другой совместимый AI-агент — и он сможет читать веб-страницы, искать в Google и Яндексе, получать новости, тренды и отзывы. Писать код не нужно.

Быстрая настройка

Быстрее всего подключить агентов с помощью официального CLI parsering. Без установки и без копирования ключей вручную — работает на macOS, Linux и Windows, нужен Node.js 18+:

npx parsering init
  1. Адрес API — нажмите Enter для https://app.parsering.com.
  2. Аккаунт — выберите Войти через браузер (рекомендуется) или Вставить API-ключ. Откроется Parser API: войдите или зарегистрируйтесь — по email, через Google, GitHub или LinkedIn — и нажмите Разрешить.
  3. API-ключ — вернитесь в терминал и выберите один из своих ключей или создайте новый с доступом ко всем инструментам.
  4. Агенты — отметьте AI-агентов (пробел — выбрать, Enter — подтвердить).
  5. Готово — перезапустите агентов, инструменты Parser API станут доступны.

init можно запускать повторно — чтобы добавить агентов или сменить аккаунт. CLI помнит прошлый выбор и не трогает другие MCP-серверы в ваших конфигах.

Поддерживаемые агенты: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code (GitHub Copilot), Codex CLI, opencode и OpenClaw.

Команды CLI

КомандаЧто делает
parsering initПодключить AI-агентов к Parser API
parsering loginВойти через браузер (сессия CLI действует 30 дней)
parsering logoutОтозвать сессию CLI и удалить сохранённые данные. Конфиги агентов не меняются
parsering whoamiПоказать email, адрес API и замаскированный ключ, который используют агенты
parsering keysСписок API-ключей и сколько MCP-инструментов доступно каждому
parsering keys use [ключ]Сменить ключ у агентов и перезаписать все конфиги, установленные CLI
parsering keys create [имя]Создать ключ со всеми разрешениями (имя по умолчанию — mcp-<имя-компьютера>)
ОпцияДля командОписание
--no-browserinit, login, keysНе открывать браузер, только показать ссылку для входа
--key <id|имя>init, keys useВыбрать API-ключ без интерактивного списка
npx parsering init --key mcp-macbook   # сразу использовать этот ключ
npx parsering keys use                 # выбрать ключ из списка
npx parsering keys create ci-agent     # создать ключ со всеми разрешениями

Сессия CLI может только просматривать список ваших API-ключей, получать выбранный ключ и создавать новые — изменить аккаунт, пароль или оплату она не может. Данные входа хранятся в ~/.config/parsering/credentials.json (%APPDATA%\parsering\credentials.json в Windows).

Эндпоинт

POST https://app.parsering.com/api/mcp

Передавайте API-ключ в заголовке Authorization: Bearer YOUR_API_KEY. Каждому инструменту нужно соответствующее разрешение ключа — parsering keys показывает, сколько инструментов доступно ключу (MCP-инструменты 8/8 — все).

Доступные инструменты

ИнструментОписаниеРазрешение ключа
parse_urlЗагрузить любую веб-страницу — Markdown (по умолчанию), HTML, текст или JSONurl
search_googleВыдача Google: органика, реклама, граф знанийserp:google
search_yandexВыдача Яндексаserp:yandex
google_newsGoogle News по запросу, теме или историиgoogle-news
google_trendsДинамика интереса, интерес по регионам, связанные запросы, подсказкиgoogle-trends
galaxy_store_reviewsОтзывы о приложениях в Samsung Galaxy Storegalaxy-store-reviews
msn_feedЛента новостей MSN для рынка (например, ru-ru)msn
opera_news_feedЛента Opera News для страны и языкаopera-news

MCP-сервер сам дожидается результата и возвращает его агенту, поэтому URL обратного вызова не нужен.

parse_url

Загружает URL в реальном браузере и возвращает содержимое страницы, cookies и, по запросу, скриншот. Аналогичен API URL Парсер.

ПараметрТипОбязательныйОписание
urlstringдаURL страницы
outputobjectнетФорматы ответа: html, markdown, text, json (boolean). По умолчанию: {"markdown": true}. Хотя бы один должен быть true
proxystringнетURL прокси: http://user:pass@host:port
useragentstringнетПользовательская строка User-Agent (только печатаемые ASCII-символы)
regionstringнетКод страны, из которой загружать страницу (например, RU, DE)
isMobilebooleanнетЭмуляция мобильного устройства
solveCaptchabooleanнетРешить капчу, если она появится (платная опция)
takeScreenshotbooleanнетДобавить скриншот страницы (платная опция)
parseHeadersbooleanнетДобавить заголовки ответа (платная опция)

search_google

Поиск в Google: возвращает структурированную выдачу — органику, рекламу и граф знаний. Аналогичен API Google SERP Парсер.

ПараметрТипОбязательныйОписание
qstringдаПоисковый запрос
countnumberдаКоличество результатов (10–100)
glstringнетКод страны (например, RU, US, DE)
hlstringнетКод языка интерфейса (например, ru, en)
canonicalLocationNamestringнетКаноническое название локации Google для выдачи по городу, например Moscow,Moscow,Russia. См. Доступные города
isDesktopbooleanнетДесктопная выдача; false — мобильная (по умолчанию: true)
useragentstringнетПользовательская строка User-Agent
screenResolutionstringнетРазрешение экрана в формате ШИРИНАxВЫСОТА, например 1920x1080
parsingDomainstringнетДомен Google для поиска, например google.com, google.ru
paramsarrayнетДополнительные параметры URL поиска Google: [{"key": "...", "value": "..."}]

search_yandex

Поиск в Яндексе: возвращает структурированную выдачу. Аналогичен API Yandex SERP Парсер.

ПараметрТипОбязательныйОписание
qstringдаПоисковый запрос
countnumberдаКоличество результатов (1–100)
regionnumberнетID региона Яндекса (параметр lr), например 213 — Москва
isDesktopbooleanнетДесктопная выдача; false — мобильная (по умолчанию: true)
takeScreenshotbooleanнетДобавить скриншот выдачи (по умолчанию: true)
useragentstringнетПользовательская строка User-Agent

google_news

Статьи Google News по поисковому запросу, теме или полному освещению истории. Тип ленты задаётся полем feed. Аналогичен API Google News Парсер.

ПараметрТипОбязательныйОписание
feedstringдаsearch, topic или stories
glstringдаКод страны (например, RU, US)
hlstringдаКод языка (например, ru, en)
limitnumberдаКоличество статей (10–100)
timeframestringнетПериод: all, 1h, 1d, 7d или 30d
qstringдля searchПоисковый запрос по новостям
bystringдля topicСпособ выбора темы: token, topicId или kgmid
topicTokenstringдля by: tokenТокен темы Google News — см. Доступные темы
topicIdstringдля by: topicIdID темы Google News
topicKgmidstringдля by: kgmidID темы в Knowledge Graph, например /m/09s1f
storiesTokenstringдля storiesТокен полного освещения истории

Данные Google Trends по запросу. Аналогичен API Google Trends Парсер.

ПараметрТипОбязательныйОписание
qstringдаКлючевое слово или фраза
typestring[]нетКакие данные вернуть: periods, geo, queries, topics, autocomplete. Если не указано — periods, geo, queries и topics. autocomplete — отдельный запрос подсказок
geostringнетКод страны, например RU; не указывайте для всего мира
datestringнетПериод: now 1-d, now 7-d, today 1-m, today 3-m, today 12-m, today 5-y, all или произвольный диапазон YYYY-MM-DD YYYY-MM-DD
catnumberнетID категории Google Trends; 0 — все категории
gpropstringнетТип поиска: web, images, news, froogle (Google Покупки) или youtube
hlstringнетЛокаль интерфейса, например ru-RU
tznumberнетСмещение часового пояса от UTC в минутах
resolutionstringнетУровень географии для интереса по регионам: COUNTRY, REGION, CITY или DMA

galaxy_store_reviews

Отзывы о приложении из Samsung Galaxy Store: оценки, текст, авторы и даты. Аналогичен API Galaxy Store Reviews Парсер.

ПараметрТипОбязательныйОписание
urlstringдаURL страницы приложения, например https://galaxystore.samsung.com/detail/com.example.app

msn_feed

Новостная лента MSN для рынка, по желанию — персональная лента пользователя MSN. Аналогичен API MSN Парсер.

ПараметрТипОбязательныйОписание
cmstringдаРынок в формате язык-страна, например ru-ru, en-us, de-de
limitintegerнетКоличество элементов ленты (1–100)
userstringнетID пользователя MSN (a-…); возвращает его персональную ленту

opera_news_feed

Лента Opera News для страны и языка, по желанию — для категории. Аналогичен API Opera News Парсер.

ПараметрТипОбязательныйОписание
countrystringдаКод страны ленты, например ru, us
languagestringдаДвухбуквенный код языка, например ru, en
limitintegerнетКоличество элементов ленты (1–100)
categorystringнетКатегория ленты, например sports; не указывайте для основной ленты

Ручная настройка

Если хотите настроить агента вручную, добавьте запись parsering в его конфиг, заменив YOUR_API_KEY на свой ключ. Именно это записывает npx parsering init.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows).

В файле конфигурации Claude Desktop поддерживает только локальные (stdio) серверы, поэтому используйте мост mcp-remote — ставить ничего не нужно, npx скачает его сам:

{
  "mcpServers": {
    "parsering": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.parsering.com/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Code

claude mcp add --transport http parsering https://app.parsering.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Или добавьте в .mcp.json в корне проекта для совместного использования командой:

{
  "mcpServers": {
    "parsering": {
      "type": "http",
      "url": "https://app.parsering.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json (глобально) или .cursor/mcp.json в корне проекта:

{
  "mcpServers": {
    "parsering": {
      "url": "https://app.parsering.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "parsering": {
      "url": "https://app.parsering.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code (GitHub Copilot)

Пользовательский mcp.json (~/Library/Application Support/Code/User/mcp.json в macOS) или .vscode/mcp.json в рабочем пространстве:

{
  "servers": {
    "parsering": {
      "type": "http",
      "url": "https://app.parsering.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex CLI

~/.codex/config.toml:

[mcp_servers.parsering]
url = "https://app.parsering.com/api/mcp"
bearer_token_env_var = "PARSERING_API_KEY"

Codex берёт ключ из переменной окружения, а не из файла конфигурации — bearer_token_env_var содержит имя этой переменной. Добавьте её в профиль оболочки (~/.zshrc, ~/.bashrc) и откройте новый терминал:

export PARSERING_API_KEY="YOUR_API_KEY"

Повторите это после parsering keys use, если сменили ключ.

opencode

~/.config/opencode/opencode.json (глобально) или ./opencode.json (проект):

{
  "mcp": {
    "parsering": {
      "type": "remote",
      "url": "https://app.parsering.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

OpenClaw

~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "parsering": {
        "url": "https://app.parsering.com/api/mcp",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

Чтобы отключить Parser API от агента, удалите запись parsering из его конфига.


Примеры использования

После подключения общайтесь с агентом в свободной форме — он сам выберет и объединит нужные инструменты.

Запарсить страницу и пересказать:

Запарси https://parsering.com и кратко изложи основной контент.

Исследовать тему через поиск:

Найди в Google «новости регулирования ИИ» и кратко изложи топ-5 результатов.

Сравнить выдачу поисковиков:

Найди «лучшие электромобили 2026» в Google и в Яндексе. Чем отличаются результаты?

Следить за конкурентами:

Запарси https://competitor.ru/pricing и выпиши все тарифы и цены.

Утренний дайджест новостей:

Найди 10 свежих статей Google News про электромобили в России за последние сутки и составь утренний дайджест.

Оценить тренд:

Покажи интерес к запросу «аэрогриль» в Google Trends по России за последние 12 месяцев и перечисли главные связанные запросы.

Анализ отзывов:

Получи отзывы из Galaxy Store для https://galaxystore.samsung.com/detail/com.example.app и сгруппируй жалобы по темам.

Решение проблем

Браузер не открылся. Скопируйте ссылку, которую показал CLI, в браузер на этом же компьютере или запустите с --no-browser.

Вход по SSH. Страница входа перенаправляет на 127.0.0.1 машины, где запущен CLI. Перед подтверждением пробросьте порт из показанной ссылки (redirect_uri=http://127.0.0.1:PORT/callback) командой ssh -L PORT:127.0.0.1:PORT ваш-сервер или выберите Вставить API-ключ в init.

«Время ожидания входа в браузере истекло». Подтвердить вход нужно в течение 5 минут. Запустите команду снова.

Инструмент завершается ошибкой доступа. У ключа нет разрешения для этого парсера. Выполните parsering keys use и выберите ключ с MCP-инструменты 8/8 или создайте новый: parsering keys create.

Агент не видит инструменты. Полностью перезапустите агента (выйдите из приложения, а не просто закройте окно). Для Codex проверьте, что переменная окружения задана в терминале, из которого он запускается.

Следующие шаги