Search1API

Servidor MCP Search1API

中文文档 | Deutsch

O servidor MCP oficial do Search1API — pesquisa na web, notícias, recuperação de páginas, descoberta de sitemaps e tópicos em alta em uma única API.

Autenticação

• Clientes compatíveis com OAuth podem se conectar diretamente à URL do MCP remoto e, em seguida, entrar e aprovar o acesso no navegador.
• Integrações existentes podem continuar usando uma chave de API do painel do Search1API.
• Toda solicitação MCP — incluindo a descoberta de ferramentas (initialize, tools/list) — exige uma credencial. Solicitações não autenticadas recebem o desafio OAuth, que é como os clientes iniciam o processo de login; a inspeção antes da conexão é fornecida pelo cartão estático do servidor.

Início rápido (MCP remoto)

Não é necessária instalação. Configure seu cliente MCP com a URL remota. Use OAuth se o cliente for compatível ou forneça uma chave de API.

Autenticação

Há suporte para três métodos — use aquele que seu cliente aceitar:

Método	Formato
OAuth 2.1	Conecte-se a https://mcp.search1api.com/mcp sem uma chave e siga o fluxo de login do cliente
Cabeçalho de autorização	Authorization: Bearer YOUR_SEARCH1API_KEY
Parâmetro de consulta da URL (legado)	https://mcp.search1api.com/mcp?apiKey=YOUR_SEARCH1API_KEY

Prefira OAuth ou o cabeçalho de autorização. Credenciais em parâmetros de consulta podem ficar expostas em URLs, logs e no histórico do shell.

Interface opcional de pesquisa e notícias

O MCP remoto expõe render_results no endpoint padrão acima. Ferramentas de dados como search, news e ask retornam resultados sem exibir cartões automaticamente. Quando uma lista de fontes for útil, o modelo pode selecionar ou combinar resultados existentes e passá-los para render_results. Essa ferramenta retorna cartões de fontes em clientes MCP Apps e uma lista de texto completa e legível nos demais casos. A renderização não repete uma pesquisa nem consome créditos de pesquisa; não é necessário nenhum parâmetro de URL para a interface.

Tanto HTTP quanto stdio anunciam o logotipo quadrado do Search1API por meio dos metadados padrão serverInfo.icons. O PNG de 512×512 é disponibilizado publicamente em https://mcp.search1api.com/assets/icon-square.png, sem autenticação nem redirecionamentos. O cartão do servidor e o manifesto do registro usam o mesmo ícone. Os clientes decidem se vão exibi-lo; ele não substitui um ícone armazenado separadamente por um diretório de plugins.

Consulte o contrato de renderização para ver os argumentos, limites e o comportamento alternativo. O pacote npm inclui esse renderizador a partir da versão 0.8.0. Atualize as instalações existentes e reinicie a conexão MCP; npx -y search1api-mcp@latest inicia o pacote publicado mais recente.

Depois de alterar a URL, reconecte ou atualize as definições de ferramentas do conector; os clientes podem armazená-las em cache. Essa configuração de URL se aplica somente ao MCP remoto; o comportamento do stdio local não muda. Consulte Interface do MCP Apps para obter detalhes e informações sobre o status da versão.

Claude Desktop

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

Claude.ai (Web)

Instale o Search1API pelo diretório do Claude, clique em Connect e entre com sua conta Search1API.

Evite adicionar https://mcp.search1api.com/mcp por meio de Add custom connector: isso cria um conector personalizado separado, que o Claude nomeia com base no host da URL (mcp.search1api.com), a menos que você informe um nome.

Cursor

Instale como um plugin do Cursor (recomendado): este repositório inclui Agent Plugins plugin.json + mcp.json (portátil) e .cursor-plugin/plugin.json (metadados/logotipo do Cursor Marketplace) para MCP remoto com OAuth. Envie ou instale pelo cursor.directory / Cursor Marketplace e entre quando solicitado.

Para testes locais, copie os arquivos do plugin para ~/.cursor/plugins/local/search1api (plugin.json, .cursor-plugin/, mcp.json, assets/). Não crie links simbólicos para fora desse diretório — o Cursor rejeita destinos de links simbólicos externos.

Ou configure manualmente:

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

Antigravity

Instale como um plugin do Antigravity: antigravity-plugin/ contém o manifesto, mcp_config.json (MCP remoto com OAuth), a skill do Search1API e um README do Marketplace. Instale diretamente do GitHub e entre quando o navegador abrir:

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

Para testes locais, execute agy plugin validate --strict ./antigravity-plugin e agy plugin install ./antigravity-plugin a partir de um checkout.

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

A Agent Skill foi transferida para search1api-cli. Instale com:

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

Modo local (stdio)

Se preferir executar o servidor localmente, use Node.js 20 ou mais recente com npx — não é necessário clonar:

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

Para implantações HTTP auto-hospedadas atrás de um proxy, adicione os nomes de host internos que chegam ao processo Node.js à variável de ambiente MCP_ALLOWED_HOSTS, separada por vírgulas. mcp.search1api.com e endereços localhost são permitidos por padrão. Clientes baseados em navegador que enviam um cabeçalho Origin também precisam ter os nomes de host de origem confiáveis adicionados à variável MCP_ALLOWED_ORIGINS, separada por vírgulas. Solicitações de clientes MCP do lado do servidor normalmente omitem Origin e não exigem uma entrada.

Ferramentas

search

Pesquise na web usando o Search1API. Os resultados incluem uma estrutura citável id/title/url. Passe uma URL de resultado para crawl quando precisar da página completa.

Parâmetro	Obrigatório	Padrão	Descrição
query	Sim	-	Consulta de pesquisa
max_results	Não	10	Número de resultados
search_service	Não	google	google, bing, bingcn, duckduckgo, yahoo, yandex, x, reddit, github, youtube, arxiv, wechat, bilibili, imdb, wikipedia, grokipedia
page	Não	1	Página de resultados (1-100); somente bing, bingcn, baidu e grokipedia permitem paginação
crawl_results	Não	0	Número de resultados principais cujo conteúdo completo será rastreado; cada rastreamento bem-sucedido adiciona 1 crédito à solicitação de pesquisa básica, que custa 1 crédito
include_sites	Não	[]	Sites a incluir
exclude_sites	Não	[]	Sites a excluir
time_range	Não	-	day, week, month, year

Os resultados incluem published_date em metadata quando o mecanismo disponibiliza esse dado; os resultados de github adicionam kind, stars, language e num_comments.

news

Pesquise artigos de notícias. Os resultados de hackernews levam ao tópico de discussão e adicionam story_url, points e num_comments a metadata.

Parâmetro	Obrigatório	Padrão	Descrição
query	Sim	-	Consulta de pesquisa
max_results	Não	10	Número de resultados
search_service	Não	bing	google, bing, duckduckgo, yahoo, hackernews
crawl_results	Não	0	Número de resultados principais cujo conteúdo completo será rastreado; cada rastreamento bem-sucedido adiciona 1 crédito à solicitação de notícias básica, que custa 1 crédito
include_sites	Não	[]	Sites a incluir
exclude_sites	Não	[]	Sites a excluir
time_range	Não	-	day, week, month, year

crawl

Extraia conteúdo de uma URL.

Parâmetro	Obrigatório	Descrição
url	Sim	URL a rastrear

sitemap

Obtenha todos os links relacionados a uma URL.

Parâmetro	Obrigatório	Descrição
url	Sim	URL para obter o sitemap

trending

Obtenha tópicos em alta de plataformas populares.

Parâmetro	Obrigatório	Padrão	Descrição
search_service	Sim	-	github, hackernews
max_results	Não	10	Número de itens

ask

Pesquisa agêntica: descreva a necessidade em linguagem natural e o Search1API selecionará até cinco mecanismos e um intervalo de tempo, descartará resultados fora do tema e retornará no máximo 10 resultados citáveis, classificados por relevância. O resultado também inclui intent (palavras-chave, mecanismos e intervalo usados) e errors (mecanismos que falharam enquanto os demais concluíram). Custa 5 créditos por solicitação concluída; use search quando já souber qual mecanismo usar.

Parâmetro	Obrigatório	Descrição
query	Sim	A solicitação em linguagem natural, com até 500 caracteres

maps

Encontre empresas e locais nas proximidades no Google Maps. Retorna uma página com até 20 locais como resultados citáveis: title é o nome do local, url é o link do Google Maps e metadata contém o endereço, telefone, site, categoria, avaliação, número de avaliações, coordenadas, horário de funcionamento, status de abertura e faixa de preço, quando disponíveis. Custa 3 créditos por página, independentemente do número de locais incluídos.

Parâmetro	Obrigatório	Padrão	Descrição
query	Sim	-	O que procurar, como "cafeterias" ou "dentistas em Austin"
country	Não	us	Código de país de duas letras
language	Não	en	Idioma dos resultados, como en, de ou zh-CN
location	Não	-	{ latitude, longitude, zoom? } para pesquisar ao redor de um ponto; obrigatório para a página 2 e posteriores
page	Não	1	Página do Google Maps, de 1 a 6; cada página é uma chamada separada
max_results	Não	20	Locais a retornar da página (1-20); retornar menos locais não reduz o preço

deepcrawl

Leia muitas páginas de um único site em uma tarefa, como uma seção de documentação. Encontra as URLs do site por meio do sitemap, mantém as que correspondem às regras de caminho e retorna até max_pages páginas como resultados citáveis: title, url e o Markdown da página em text. O resultado também inclui stats (descobertas, correspondentes, ignoradas, rastreadas, com falha), failed (URLs que não puderam ser lidas, com o motivo), a API message e result_url, um arquivo JSON com todas as páginas completas. Custa 20 créditos por tarefa iniciada, independentemente do número de páginas lidas.

A ferramenta aguarda até cerca de 45 segundos. Se o rastreamento ainda estiver em andamento, retorna status: "running" com um task_id; chame deepcrawl novamente com esse task_id para coletar as páginas. Isso é gratuito e não inicia um novo rastreamento. O texto de cada página é limitado a 8.000 caracteres, e o total, a 80.000; páginas encurtadas têm metadata.truncated: true, e result_url contém o texto completo.

Parâmetro	Obrigatório	Padrão	Descrição
url	Sim, a menos que task_id seja informado	-	Site ou seção a rastrear, como https://example.com/docs/
max_pages	Não	10	Número máximo de páginas a ler (1-50), na ordem de descoberta após a aplicação das regras de caminho; o preço é o mesmo para qualquer quantidade
include_paths	Não	-	Até 20 regras de caminho de URL a manter. Sem *, uma regra é um prefixo de caminho nos limites dos segmentos (/docs corresponde a /docs/api, mas não a /docsearch); com *, deve corresponder ao caminho inteiro, e * também corresponde a /
exclude_paths	Não	-	Até 20 regras de caminho a ignorar, com a mesma sintaxe; a exclusão tem prioridade
type	Não	sitemap	sitemap usa o sitemap do site ou, se não houver, os links da página inicial; all usa todos os links descobertos a partir da URL inicial
task_id	Não	-	task_id de um rastreamento que ainda estava em andamento; verifica apenas o status, e os outros parâmetros são ignorados

send_feedback

Informe à equipe do Search1API sobre um resultado incorreto, vazio ou incompleto, um erro que você não conseguiu resolver, documentação que não corresponde ao comportamento ou um recurso ausente. É gratuito e não consome créditos. Quando o servidor tem uma credencial do Search1API, o relatório é associado a essa conta para que a equipe possa dar seguimento. Não inclua credenciais nem dados privados.

Parâmetro	Obrigatório	Descrição
message	Sim	O que deu errado ou estava faltando, até 4000 caracteres
intent	Não	O que você estava tentando realizar
category	Não	bug, feature_request, docs, other
request_id	Não	ID da solicitação da chamada que apresentou o problema
model	Não	Nome do seu modelo

Histórico de versões

• v0.11.0: Nova ferramenta deepcrawl para ler até 50 páginas de um site em uma única tarefa (20 créditos por tarefa; verificar uma tarefa em andamento é grátis)

• v0.10.0: Nova ferramenta maps para pesquisar lugares no Google Maps (3 créditos por página com até 20 lugares)

• v0.7.0: Nova ferramenta ask para pesquisa agêntica. search adiciona os mecanismos bingcn, yandex e grokipedia, além de um parâmetro page; search e news aceitam time_range: "week" e repassam os campos de published_date, GitHub e Hacker News nos resultados de metadata

• v0.6.1: Correção de bug — a descoberta MCP (initialize, tools/list, resources/*, prompts/list, server/discover) exige uma credencial novamente. Disponibilizá-la anonimamente fazia com que clientes que equiparam “ferramentas listadas” a “conectado” exibissem um estado conectado sem oferecer uma forma de iniciar o fluxo OAuth; agora, o desafio 401 responde a todas as solicitações não autenticadas, restaurando o login OAuth no momento da conexão. A visibilidade no diretório permanece inalterada por meio do cartão estático do servidor e dos metadados do registro

• v0.6.0: A descoberta MCP (initialize, tools/list, resources/*, prompts/list, server/discover) é disponibilizada sem credencial para que clientes e diretórios possam enumerar ferramentas antes do login; as chamadas de ferramentas ainda exigem OAuth ou uma chave de API. O modo Stdio inicia sem SEARCH1API_KEY e disponibiliza os metadados das ferramentas, recusando solicitações somente no momento da chamada. Solicitações malformadas recebem uma resposta JSON-RPC em vez de uma página de erro HTML

• v0.5.4: O emissor OAuth foi movido para clerk.s1.dev e pode ser configurado com OAUTH_AUTHORIZATION_SERVER; cartão do servidor MCP publicado em /.well-known/mcp/server-card.json; os documentos de descoberta OAuth agora enviam cabeçalhos de cache

• v0.5.3: Os metadados de recursos OAuth e ferramentas não exigem mais escopos de sessão OIDC; distintivos dos registros Smithery e Glama adicionados

• v0.5.2: A validação MCP Origin agora é executada antes da análise e autenticação da solicitação; implantações HTTP auto-hospedadas podem configurar origens de navegador confiáveis com MCP_ALLOWED_ORIGINS

• v0.5.1: Documentação, manifesto do LobeHub e metadados do MCP Registry sincronizados; robots.txt disponibilizado no host de transporte

• v0.5.0: Suporte ao MCP 2026-07-28 com negociação automática de protocolo; compatibilidade sem estado para clientes HTTP da era 2025; autenticação no nível da solicitação

• v0.4.0: Esquemas de saída estruturada, esquemas de segurança OAuth, anotações de segurança e metadados do Official MCP Registry

• v0.3.1: Suporte a OAuth 2.1 para Remote MCP; ferramenta de raciocínio descontinuada removida

• v0.3.0: Suporte a Remote MCP via Streamable HTTP; autenticação por chave de API por sessão

• v0.2.0: Suporte alternativo a .env para integração com LibreChat

• v0.1.8: Serviços de pesquisa do X (Twitter) e Reddit

• v0.1.7: Ferramenta de tendências para GitHub e Hacker News

• v0.1.6: Serviço de pesquisa da Wikipedia

• v0.1.5: Novos parâmetros e serviços de pesquisa (arxiv, wechat, bilibili, imdb)

• v0.1.3: Pesquisa de notícias

• v0.1.2: Sitemap

• v0.1.1: Rastreamento da web

• v0.1.0: Lançamento inicial

Licença

MIT

Créditos da interface e de terceiros

A visualização MCP Apps de render_results mostra as fontes existentes como cartões com títulos e domínios. Cada cliente também recebe o texto completo e a lista estruturada de resultados. O componente é adaptado de Rare UI, de Swami Malode. Os termos MIT + Commons Clause + Attribution estão reproduzidos em THIRD_PARTY_NOTICES.md.

Configuração da interface, origem do sandbox e verificações de lançamento: MCP Apps UI.