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
- Адрес API — нажмите Enter для
https://app.parsering.com. - Аккаунт — выберите Войти через браузер (рекомендуется) или Вставить API-ключ. Откроется Parser API: войдите или зарегистрируйтесь — по email, через Google, GitHub или LinkedIn — и нажмите Разрешить.
- API-ключ — вернитесь в терминал и выберите один из своих ключей или создайте новый с доступом ко всем инструментам.
- Агенты — отметьте AI-агентов (пробел — выбрать, Enter — подтвердить).
- Готово — перезапустите агентов, инструменты 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-browser | init, 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, текст или JSON | url |
search_google | Выдача Google: органика, реклама, граф знаний | serp:google |
search_yandex | Выдача Яндекса | serp:yandex |
google_news | Google News по запросу, теме или истории | google-news |
google_trends | Динамика интереса, интерес по регионам, связанные запросы, подсказки | google-trends |
galaxy_store_reviews | Отзывы о приложениях в Samsung Galaxy Store | galaxy-store-reviews |
msn_feed | Лента новостей MSN для рынка (например, ru-ru) | msn |
opera_news_feed | Лента Opera News для страны и языка | opera-news |
MCP-сервер сам дожидается результата и возвращает его агенту, поэтому URL обратного вызова не нужен.
parse_url
Загружает URL в реальном браузере и возвращает содержимое страницы, cookies и, по запросу, скриншот. Аналогичен API URL Парсер.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| url | string | да | URL страницы |
| output | object | нет | Форматы ответа: html, markdown, text, json (boolean). По умолчанию: {"markdown": true}. Хотя бы один должен быть true |
| proxy | string | нет | URL прокси: http://user:pass@host:port |
| useragent | string | нет | Пользовательская строка User-Agent (только печатаемые ASCII-символы) |
| region | string | нет | Код страны, из которой загружать страницу (например, RU, DE) |
| isMobile | boolean | нет | Эмуляция мобильного устройства |
| solveCaptcha | boolean | нет | Решить капчу, если она появится (платная опция) |
| takeScreenshot | boolean | нет | Добавить скриншот страницы (платная опция) |
| parseHeaders | boolean | нет | Добавить заголовки ответа (платная опция) |
search_google
Поиск в Google: возвращает структурированную выдачу — органику, рекламу и граф знаний. Аналогичен API Google SERP Парсер.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| q | string | да | Поисковый запрос |
| count | number | да | Количество результатов (10–100) |
| gl | string | нет | Код страны (например, RU, US, DE) |
| hl | string | нет | Код языка интерфейса (например, ru, en) |
| canonicalLocationName | string | нет | Каноническое название локации Google для выдачи по городу, например Moscow,Moscow,Russia. См. Доступные города |
| isDesktop | boolean | нет | Десктопная выдача; false — мобильная (по умолчанию: true) |
| useragent | string | нет | Пользовательская строка User-Agent |
| screenResolution | string | нет | Разрешение экрана в формате ШИРИНАxВЫСОТА, например 1920x1080 |
| parsingDomain | string | нет | Домен Google для поиска, например google.com, google.ru |
| params | array | нет | Дополнительные параметры URL поиска Google: [{"key": "...", "value": "..."}] |
search_yandex
Поиск в Яндексе: возвращает структурированную выдачу. Аналогичен API Yandex SERP Парсер.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| q | string | да | Поисковый запрос |
| count | number | да | Количество результатов (1–100) |
| region | number | нет | ID региона Яндекса (параметр lr), например 213 — Москва |
| isDesktop | boolean | нет | Десктопная выдача; false — мобильная (по умолчанию: true) |
| takeScreenshot | boolean | нет | Добавить скриншот выдачи (по умолчанию: true) |
| useragent | string | нет | Пользовательская строка User-Agent |
google_news
Статьи Google News по поисковому запросу, теме или полному освещению истории. Тип ленты задаётся полем feed. Аналогичен API Google News Парсер.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| feed | string | да | search, topic или stories |
| gl | string | да | Код страны (например, RU, US) |
| hl | string | да | Код языка (например, ru, en) |
| limit | number | да | Количество статей (10–100) |
| timeframe | string | нет | Период: all, 1h, 1d, 7d или 30d |
| q | string | для search | Поисковый запрос по новостям |
| by | string | для topic | Способ выбора темы: token, topicId или kgmid |
| topicToken | string | для by: token | Токен темы Google News — см. Доступные темы |
| topicId | string | для by: topicId | ID темы Google News |
| topicKgmid | string | для by: kgmid | ID темы в Knowledge Graph, например /m/09s1f |
| storiesToken | string | для stories | Токен полного освещения истории |
google_trends
Данные Google Trends по запросу. Аналогичен API Google Trends Парсер.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| q | string | да | Ключевое слово или фраза |
| type | string[] | нет | Какие данные вернуть: periods, geo, queries, topics, autocomplete. Если не указано — periods, geo, queries и topics. autocomplete — отдельный запрос подсказок |
| geo | string | нет | Код страны, например RU; не указывайте для всего мира |
| date | string | нет | Период: 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 |
| cat | number | нет | ID категории Google Trends; 0 — все категории |
| gprop | string | нет | Тип поиска: web, images, news, froogle (Google Покупки) или youtube |
| hl | string | нет | Локаль интерфейса, например ru-RU |
| tz | number | нет | Смещение часового пояса от UTC в минутах |
| resolution | string | нет | Уровень географии для интереса по регионам: COUNTRY, REGION, CITY или DMA |
galaxy_store_reviews
Отзывы о приложении из Samsung Galaxy Store: оценки, текст, авторы и даты. Аналогичен API Galaxy Store Reviews Парсер.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| url | string | да | URL страницы приложения, например https://galaxystore.samsung.com/detail/com.example.app |
msn_feed
Новостная лента MSN для рынка, по желанию — персональная лента пользователя MSN. Аналогичен API MSN Парсер.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| cm | string | да | Рынок в формате язык-страна, например ru-ru, en-us, de-de |
| limit | integer | нет | Количество элементов ленты (1–100) |
| user | string | нет | ID пользователя MSN (a-…); возвращает его персональную ленту |
opera_news_feed
Лента Opera News для страны и языка, по желанию — для категории. Аналогичен API Opera News Парсер.
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| country | string | да | Код страны ленты, например ru, us |
| language | string | да | Двухбуквенный код языка, например ru, en |
| limit | integer | нет | Количество элементов ленты (1–100) |
| category | string | нет | Категория ленты, например 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 проверьте, что переменная окружения задана в терминале, из которого он запускается.
Следующие шаги
- Аутентификация — управление API-ключами и разрешениями
- URL Парсер — прямое использование REST API
- Google SERP Парсер — REST API для поиска Google
- Google News Парсер — REST API для Google News
- Тарифы — каждый вызов инструмента стоит столько же, сколько аналогичный запрос к REST API