Search1API

Search1API MCP Server

中文文档

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

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

• Клиенты с поддержкой OAuth могут подключаться напрямую к Remote MCP URL, затем войти и подтвердить доступ в браузере.
• Существующие интеграции могут продолжать использовать API-ключ из панели управления Search1API.

Быстрый старт (Remote MCP)

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

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

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

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

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

Claude Desktop

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

Claude.ai (Web)

Настройки > Подключения > Добавить пользовательский коннектор:

https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Cursor

Установите как плагин Cursor (рекомендуется): этот репозиторий включает Agent Plugins plugin.json + mcp.json (переносимые) и .cursor-plugin/plugin.json (метаданные / логотип Cursor Marketplace) для Remote 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"
      }
    }
  }
}

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"
    }
  }
}

Agent Skill

Agent Skill перемещён в 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, duckduckgo, yahoo, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia
crawl_results	Нет	0	Количество лучших результатов для обхода с целью получения полного содержимого; каждый успешный обход добавляет 1 кредит к базовому запросу поиска стоимостью 1 кредит
include_sites	Нет	[]	Сайты для включения
exclude_sites	Нет	[]	Сайты для исключения
time_range	Нет	-	день, месяц, год

news

Поиск новостных статей.

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

crawl

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

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

sitemap

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

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

trending

Получение популярных тем с популярных платформ.

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

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

• v0.5.3: Ресурсы OAuth и метаданные инструментов больше не требуют областей сеанса OIDC; добавлены значки реестров Smithery и Glama
• v0.5.2: Проверка MCP Origin теперь выполняется до разбора запроса и аутентификации; самостоятельные HTTP-развёртывания могут настраивать доверенные источники браузера с помощью MCP_ALLOWED_ORIGINS
• v0.5.1: Документация, манифест LobeHub и метаданные MCP Registry синхронизированы; robots.txt обслуживается на транспортном хосте
• v0.5.0: Поддержка MCP 2026-07-28 с автоматическим согласованием протокола; совместимость без сохранения состояния для HTTP-клиентов 2025 года; аутентификация на уровне запросов
• v0.4.0: Схемы структурированного вывода, схемы безопасности OAuth, аннотации безопасности и метаданные Official MCP Registry
• 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: Карта сайта
• v0.1.1: Веб-обход
• v0.1.0: Первый выпуск

Лицензия

MIT