Servidor MCP
O servidor oficial do Model Context Protocol expõe a serp.cheap como uma ferramenta que agentes de IA podem chamar para
obter resultados ao vivo do Google. É um cliente de API puro — ele fala apenas com o POST /v1/search público.
- Pacote:
@serpcheap/mcp(bin npxserpcheap-mcp) - Ferramenta:
google_search - Transportes: stdio (padrão) e Streamable HTTP sem estado
A ferramenta google_search
Seção intitulada “A ferramenta google_search”| Argumento | Tipo | Padrão | Notas |
|---|---|---|---|
q | string (1–500) | — | A consulta de busca (obrigatório). |
gl | enum | us | País: br us gb de fr es it mx ca au jp nl. |
hl | string | padrão do país | Idioma dos resultados (BCP-47, ex.: en, pt-BR). |
tbs | enum | todo o período | Filtro de tempo: qdr:h / qdr:d / qdr:w. |
page | int (1–99) | 1 | Página de resultados (~10 resultados orgânicos cada). |
Ela retorna o mesmo JSON que a resposta REST (orgânicos, Knowledge Graph, stats), renderizado como markdown legível para o modelo.
Configuração mais rápida (Claude Code)
Seção intitulada “Configuração mais rápida (Claude Code)”claude mcp add google-cheap-search -e SERPCHEAP_API_KEY=your-key -- npx -y @serpcheap/mcpPara Claude Desktop, Cursor, Windsurf e o transporte HTTP remoto, veja Configuração & clientes.