Search1API

Search1API MCP Server

中文文档

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

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

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

Быстрый старт (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"
    }
  }
}

Навык агента

Навык агента перемещен в 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	Нет	-	day, month, year

news

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

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

crawl

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

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

sitemap

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

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

trending

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

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

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

• 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 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: Инструмент Trending для 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