Search1API

официальный

Один API для поиска, краулинга и карт сайта

GitHub

175

Что можно делать с Search1API MCP?

Веб-поиск — Попросите ассистента выполнить search в таких системах, как Google, Bing, GitHub, arXiv или Reddit, с фильтрами по сайтам и временными диапазонами.
Поиск новостей — Используйте news, чтобы найти свежие статьи в Google, Bing, DuckDuckGo, Yahoo или Hacker News, при необходимости просканировав лучшие результаты.
Получение страниц и карт сайта — Извлекайте полное содержимое по URL или получайте список всех связанных ссылок с сайта.
Популярные темы — Получайте популярные материалы с GitHub или Hacker News.
Агентный поиск — Опишите задачу на естественном языке и позвольте ask выбрать поисковые системы и выдать ранжированные результаты с указанием источников.
Поиск мест поблизости — Находите компании и места в Google Maps с адресами, рейтингами, часами работы и контактными данными.

Документация

MCP-сервер Search1API

中文文档 | Deutsch

Официальный MCP-сервер для Search1API — веб-поиск, новости, получение страниц, поиск карт сайта и популярные темы в одном API.

Аутентификация

Клиенты с поддержкой OAuth могут подключиться напрямую к удалённому URL MCP, затем войти в систему и подтвердить доступ в браузере.
Существующие интеграции могут и дальше использовать API-ключ из панели Search1API.
Для каждого запроса MCP, включая обнаружение инструментов (initialize, tools/list), требуются учётные данные. Неаутентифицированные запросы получают вызов OAuth-аутентификации, с помощью которого клиенты запускают вход в систему; предварительный просмотр до подключения доступен в статической карточке сервера.

Быстрый старт (удалённый MCP)

Установка не требуется. Настройте MCP-клиент, указав удалённый URL. Используйте OAuth, если клиент его поддерживает, или укажите API-ключ.

Аутентификация

Поддерживаются три способа — выберите тот, который поддерживает ваш клиент:

Способ	Формат
OAuth 2.1	Подключитесь к `https://mcp.search1api.com/mcp` без ключа и следуйте инструкциям клиента для входа
Заголовок Authorization	`Authorization: Bearer YOUR_SEARCH1API_KEY`
Параметр URL-запроса (устаревший)	`https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY`

Предпочтительно использовать OAuth или заголовок Authorization. Учётные данные в параметрах запроса могут попасть в URL, журналы и историю командной оболочки.

Необязательный интерфейс поиска и новостей

Удалённый MCP предоставляет render_results по указанной выше стандартной конечной точке. Инструменты для работы с данными, такие как search, news и ask, возвращают результаты, но не отображают карточки автоматически. Если полезен список источников, модель может выбрать или объединить существующие результаты и передать их в render_results. В клиентах MCP Apps он возвращает карточки источников, а в остальных — полный текстовый список для чтения. Отображение не запускает поиск повторно и не расходует кредиты на поиск; параметр URL для интерфейса не требуется.

HTTP и stdio объявляют квадратный логотип Search1API через стандартные метаданные serverInfo.icons. PNG размером 512×512 доступен публично по адресу https://mcp.search1api.com/assets/icon-square.png, без аутентификации и перенаправлений. В карточке сервера и манифесте реестра используется тот же значок. Клиенты сами решают, отображать ли его; он не заменяет значок, отдельно сохранённый в каталоге плагинов.

Аргументы, ограничения и поведение при отсутствии поддержки описаны в контракте отображения. Этот рендерер входит в npm-пакет начиная с версии 0.8.0. Обновите существующие установки и перезапустите подключение MCP; npx -y search1api-mcp@latest запускает последнюю опубликованную версию пакета.

После изменения URL переподключите коннектор или обновите определения его инструментов; клиенты могут кэшировать их. Эта настройка URL применяется только к удалённому MCP; поведение локального stdio не меняется. Подробности и статус выпуска см. в разделе MCP Apps UI.

Claude Desktop

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude.ai (Web)

Установите Search1API из каталога Claude, нажмите Connect и войдите в систему с учётной записью Search1API.

Не добавляйте https://mcp.search1api.com/mcp через Add custom connector: так создаётся отдельный пользовательский коннектор, которому Claude присваивает имя по хосту URL (mcp.search1api.com), если вы не укажете имя вручную.

Cursor

Установите как плагин Cursor (рекомендуется): этот репозиторий содержит Agent Plugins plugin.json + mcp.json (переносимые) и .cursor-plugin/plugin.json (метаданные / логотип Cursor Marketplace) для удалённого MCP с OAuth. Отправьте плагин на проверку или установите его из cursor.directory / Cursor Marketplace, затем войдите в систему по запросу.

Для локального тестирования скопируйте файлы плагина в ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/). Не создавайте символические ссылки из каталогов за пределами этой директории — Cursor отклоняет внешние цели символических ссылок.

Или настройте вручную:

{
  "mcpServers": {
    "search1api": {
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Antigravity

Установите как плагин Antigravity: antigravity-plugin/ содержит манифест, mcp_config.json (удалённый MCP с OAuth), навык Search1API и README для Marketplace. Установите его напрямую из GitHub, затем войдите в систему, когда откроется браузер:

agy plugin install https://github.com/superagents-lab/search1api-mcp/tree/main/antigravity-plugin

Для локального тестирования выполните agy plugin validate --strict ./antigravity-plugin и agy plugin install ./antigravity-plugin из клонированного репозитория.

VS Code

{
  "servers": {
    "search1api": {
      "type": "http",
      "url": "https://mcp.search1api.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Claude Code

claude mcp add --transport http search1api https://mcp.search1api.com/mcp \
  --header "Authorization: Bearer YOUR_SEARCH1API_KEY"

Windsurf

{
  "mcpServers": {
    "search1api": {
      "serverUrl": "https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY"
    }
  }
}

Навык агента

Навык агента перенесён в search1api-cli. Установите его командой:

npm install -g search1api-cli
npx skills add superagents-lab/search1api-cli

Локальный режим (stdio)

Если вы предпочитаете запускать сервер локально, используйте Node.js 20 или новее с npx — клонировать репозиторий не нужно:

{
  "mcpServers": {
    "search1api": {
      "command": "npx",
      "args": ["-y", "search1api-mcp"],
      "env": {
        "SEARCH1API_KEY": "YOUR_SEARCH1API_KEY"
      }
    }
  }
}

Для самостоятельного размещения HTTP-сервера за прокси добавьте все внутренние имена хостов, по которым доступен процесс Node.js, в переменную окружения MCP_ALLOWED_HOSTS, содержащую значения, разделённые запятыми. По умолчанию разрешены mcp.search1api.com и адреса localhost. Клиентам на основе браузера, которые отправляют заголовок Origin, также нужно добавить доверенные имена хостов источников в переменную MCP_ALLOWED_ORIGINS, содержащую значения, разделённые запятыми. Запросы от серверных MCP-клиентов обычно не содержат Origin, поэтому добавлять их не требуется.

Инструменты

search

Поиск в интернете с помощью Search1API. Результаты содержат структуру id/title/url, пригодную для цитирования. Передайте URL результата в crawl, если нужна полная страница.

Параметр	Обязательный	По умолчанию	Описание
`query`	Да	-	Поисковый запрос
`max_results`	Нет	10	Количество результатов
`search_service`	Нет	google	google, bing, bingcn, duckduckgo, yahoo, yandex, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia, grokipedia
`page`	Нет	1	Страница результатов (1–100); постраничная навигация доступна только для bing, bingcn, baidu и grokipedia
`crawl_results`	Нет	0	Количество лучших результатов для извлечения полного содержимого; каждое успешное извлечение добавляет 1 кредит к базовой стоимости поискового запроса в 1 кредит
`include_sites`	Нет	[]	Сайты для включения
`exclude_sites`	Нет	[]	Сайты для исключения
`time_range`	Нет	-	day, week, month, year

Если поисковая система предоставляет published_date, результаты содержат его в metadata; результаты github дополнительно содержат kind, stars, language и num_comments.

news

Поиск новостных статей. Результаты hackernews ведут на страницу обсуждения и добавляют story_url, points и num_comments в metadata.

Параметр	Обязательный	По умолчанию	Описание
`query`	Да	-	Поисковый запрос
`max_results`	Нет	10	Количество результатов
`search_service`	Нет	bing	google, bing, duckduckgo, yahoo, hackernews
`crawl_results`	Нет	0	Количество лучших результатов для извлечения полного содержимого; каждое успешное извлечение добавляет 1 кредит к базовой стоимости новостного запроса в 1 кредит
`include_sites`	Нет	[]	Сайты для включения
`exclude_sites`	Нет	[]	Сайты для исключения
`time_range`	Нет	-	day, week, month, year

crawl

Извлечение содержимого по URL.

Параметр	Обязательный	Описание
`url`	Да	URL для извлечения

sitemap

Получение всех связанных ссылок по URL.

Параметр	Обязательный	Описание
`url`	Да	URL для получения карты сайта

Параметр	Обязательный	По умолчанию	Описание
`search_service`	Да	-	github, hackernews
`max_results`	Нет	10	Количество элементов

ask

Агентный поиск: опишите потребность обычным языком, и Search1API выберет до пяти поисковых систем и временной интервал, отсеет нерелевантные результаты и вернёт не более 10 результатов, пригодных для цитирования, отсортированных по релевантности. Результат также содержит intent (использованные ключевые слова, поисковые системы и временной интервал) и errors (поисковые системы, в которых произошёл сбой, пока остальные завершили работу). Стоимость каждого успешно выполненного запроса — 5 кредитов; если поисковая система уже известна, используйте search.

Параметр	Обязательный	Описание
`query`	Да	Запрос на естественном языке длиной до 500 символов

maps

Поиск мест и компаний в Google Maps. Возвращает одну страницу с максимум 20 местами в виде результатов, пригодных для цитирования: title — название места, url — ссылка на него в Google Maps, а metadata содержит адрес, телефон, сайт, категорию, рейтинг, количество отзывов, координаты, часы работы, статус открытия и диапазон цен, если эти данные доступны. Стоимость одной страницы — 3 кредита независимо от количества мест на ней.

Параметр	Обязательный	По умолчанию	Описание
`query`	Да	-	Что искать, например «кофейни» или «стоматологи в Остине»
`country`	Нет	us	Двухбуквенный код страны
`language`	Нет	en	Язык результатов, например en, de или zh-CN
`location`	Нет	-	`{ latitude, longitude, zoom? }` для поиска рядом с точкой; обязателен для второй и последующих страниц
`page`	Нет	1	Страница Google Maps, 1–6; для каждой страницы нужен отдельный вызов
`max_results`	Нет	20	Количество мест на странице (1–20); меньшее количество мест не снижает стоимость

deepcrawl

Чтение множества страниц одного сайта за одну задачу, например раздела документации. Находит URL сайта через его карту сайта, оставляет соответствующие правилам путей и возвращает до max_pages страниц в виде результатов, пригодных для цитирования: title, url и Markdown страницы в text. Результат также содержит stats (обнаружено, соответствует правилам, пропущено, прочитано, ошибки), failed (URL, которые не удалось прочитать, с указанием причины), API message и result_url — JSON-файл с полным содержимым каждой страницы. Стоимость каждой запущенной задачи — 20 кредитов независимо от количества прочитанных страниц.

Инструмент ожидает около 45 секунд. Если обход ещё выполняется, он возвращает status: "running" с task_id; вызовите deepcrawl ещё раз с этим task_id, чтобы получить страницы. Это бесплатно и не запускает новый обход. Текст каждой страницы ограничен 8 000 символами, а общий объём — 80 000 символами; для сокращённых страниц предусмотрен metadata.truncated: true, а result_url содержит полный текст.

Параметр	Обязательный	По умолчанию	Описание
`url`	Да, если не указан `task_id`	-	Сайт или раздел для обхода, например `https://example.com/docs/`
`max_pages`	Нет	10	Максимальное количество страниц для чтения (1–50) в порядке обнаружения после применения правил путей; стоимость одинакова при любом количестве
`include_paths`	Нет	-	До 20 правил путей для включения. Без `` правило задаёт префикс пути по границам сегментов (`/docs` соответствует `/docs/api`, но не `/docsearch`); с `` оно должно соответствовать всему пути, а `*` также соответствует `/`
`exclude_paths`	Нет	-	До 20 правил путей для исключения, тот же синтаксис; исключение имеет приоритет
`type`	Нет	sitemap	`sitemap` использует карту сайта или ссылки на стартовой странице, если карты сайта нет; `all` использует все ссылки, обнаруженные по стартовому URL
`task_id`	Нет	-	`task_id` обхода, который ещё выполнялся; проверяет только его статус, остальные параметры игнорируются

send_feedback

Сообщите команде Search1API о неверном, пустом или неполном результате, ошибке, которую не удалось устранить, документации, не соответствующей фактическому поведению, или отсутствующей возможности. Бесплатно; кредиты не расходуются. Если сервер располагает учётными данными Search1API, отчёт связывается с этой учётной записью, чтобы команда могла связаться с вами. Не указывайте учётные данные или личные данные.

Параметр	Обязательный	Описание
`message`	Да	Что пошло не так или чего не хватало, до 4000 символов
`intent`	Нет	Чего вы пытались добиться
`category`	Нет	bug, feature_request, docs, other
`request_id`	Нет	Идентификатор запроса вызова, при котором возникла проблема
`model`	Нет	Название вашей модели

История версий

v0.11.0: Новый инструмент deepcrawl для чтения до 50 страниц одного сайта в рамках одной задачи (20 кредитов за задачу; проверка выполняющейся задачи бесплатна)
v0.10.0: Новый инструмент maps для поиска мест в Google Maps (3 кредита за страницу, содержащую до 20 мест)
v0.7.0: Новый инструмент ask для агентного поиска. search добавляет движки bingcn, yandex и grokipedia, а также параметр page; search и news принимают time_range: "week" и передают поля published_date, GitHub и Hacker News в результат metadata
v0.6.1: Исправлена ошибка — для обнаружения MCP (initialize, tools/list, resources/*, prompts/list, server/discover) снова требуются учетные данные. Анонимный доступ к нему приводил к тому, что клиенты, приравнивающие «список инструментов получен» к «вход выполнен», показывали состояние подключения без возможности запустить поток OAuth; теперь ответ 401 на каждый неаутентифицированный запрос восстанавливает вход через OAuth при подключении. Видимость в каталогах не изменилась благодаря статической карточке сервера и метаданным реестра
v0.6.0: Обнаружение MCP (initialize, tools/list, resources/*, prompts/list, server/discover) выполняется без учетных данных, чтобы клиенты и каталоги могли перечислять инструменты до входа; для вызова инструментов по-прежнему требуются OAuth или ключ API. Режим stdio запускается без SEARCH1API_KEY и предоставляет метаданные инструментов, отклоняя запрос только во время вызова. Некорректные запросы получают ответ в формате JSON-RPC вместо страницы ошибки HTML
v0.5.4: Издатель OAuth перенесен на clerk.s1.dev и настраивается с помощью OAUTH_AUTHORIZATION_SERVER; карточка сервера MCP опубликована по адресу /.well-known/mcp/server-card.json; документы обнаружения OAuth теперь содержат заголовки кэширования
v0.5.3: Для ресурса OAuth и метаданных инструментов больше не требуются области сеанса OIDC; добавлены значки реестров Smithery и Glama
v0.5.2: Проверка MCP Origin теперь выполняется до разбора запроса и аутентификации; в самостоятельно размещаемых HTTP-развертываниях можно настроить доверенные источники браузера с помощью MCP_ALLOWED_ORIGINS
v0.5.1: Синхронизированы документация, манифест LobeHub и метаданные реестра MCP; robots.txt предоставляется на хосте транспорта
v0.5.0: Поддержка MCP 2026-07-28 с автоматическим согласованием протокола; совместимость без сохранения состояния с HTTP-клиентами эпохи 2025 года; аутентификация на уровне запроса
v0.4.0: Схемы структурированного вывода, схемы безопасности OAuth, аннотации безопасности и метаданные официального реестра MCP
v0.3.1: Добавлена поддержка OAuth 2.1 для Remote MCP; устаревший инструмент рассуждений удален
v0.3.0: Добавлена поддержка Remote MCP через Streamable HTTP; аутентификация с помощью ключа API для каждого сеанса
v0.2.0: Добавлена поддержка резервного .env для интеграции с LibreChat
v0.1.8: Сервисы поиска по X (Twitter) и Reddit
v0.1.7: Инструмент для поиска популярных материалов на GitHub и Hacker News
v0.1.6: Сервис поиска по Wikipedia
v0.1.5: Новые параметры и сервисы поиска (arxiv, wechat, bilibili, imdb)
v0.1.3: Поиск новостей
v0.1.2: Sitemap
v0.1.1: Обход веб-сайтов
v0.1.0: Первый выпуск

Лицензия

MIT

Благодарности за UI и сторонние материалы

Представление MCP Apps render_results показывает существующие источники в виде карточек с заголовками и доменами. Каждый клиент также получает полный текст и структурированный список результатов. Компонент адаптирован из Rare UI, автор — Swami Malode. Условия MIT + Commons Clause + Attribution воспроизведены в THIRD_PARTY_NOTICES.md.

Настройка UI, источник песочницы и проверки выпуска: MCP Apps UI.

Search1API

Что можно делать с Search1API MCP?

Документация

MCP-сервер Search1API

Аутентификация

Быстрый старт (удалённый MCP)

Аутентификация

Необязательный интерфейс поиска и новостей

Claude Desktop

Claude.ai (Web)

Cursor

Antigravity

VS Code

Claude Code

Windsurf

Навык агента

Локальный режим (stdio)

Инструменты

search

news

crawl

sitemap

trending

ask

maps

deepcrawl

send_feedback

История версий

Лицензия

Благодарности за UI и сторонние материалы