ClawFetch

@clawfetch/mcp

Servidor MCP (Model Context Protocol) para ClawFetch — API de Inteligência Web para Agentes de IA.

Oferece a qualquer cliente compatível com MCP (Claude Desktop, Cursor, Windsurf, OpenClaw, etc.) acesso instantâneo às ferramentas de inteligência web do ClawFetch: buscar páginas como markdown, renderizar SPAs com muito JavaScript, extrair dados estruturados de mais de 17 tipos de sites, pesquisar tópicos em múltiplas fontes e verificar disponibilidade de domínios.

Os pagamentos são tratados automaticamente via protocolo x402 — USDC na Base. Sem chaves de API, sem painéis de cobrança.

Acesso e pagamento

O endpoint MCP público hospedado foi descontinuado e retorna HTTP 410 Gone. Execute o MCP localmente usando a configuração abaixo, ou chame https://api.clawfetch.ai diretamente. Chamadas de ferramentas pagas usam sua própria carteira financiada com USDC na Base; o ClawFetch não subsidia solicitações.

💻 Modo Auto-Hospedado

Execute sua própria instância com controle total sobre a carteira de pagamento.

Instalação

npm install -g @clawfetch/mcp

Configuração (stdio — para clientes MCP locais)

Adicione à configuração do seu cliente MCP (ex.: Claude Desktop):

{
  "mcpServers": {
    "clawfetch": {
      "command": "clawfetch-mcp",
      "env": {
        "CLAWFETCH_PRIVATE_KEY": "0xYOUR_ETHEREUM_PRIVATE_KEY"
      }
    }
  }
}

A chave privada assina micropagamentos x402 (USDC na Base). Financie o endereço correspondente com USDC na mainnet da Base.

Executar como Servidor HTTP

Exponha o servidor MCP via HTTP para clientes remotos:

CLAWFETCH_PRIVATE_KEY=0x... CLAWFETCH_TRANSPORT=http CLAWFETCH_PORT=3001 clawfetch-mcp

Isso inicia um servidor em http://localhost:3001/mcp usando o transporte HTTP Streamable (compatível com a especificação MCP).

Endpoints HTTP

Endpoint	Método	Descrição
/mcp	POST	Inicializa a sessão — retorna o cabeçalho Mcp-Session-Id
/mcp	GET	Stream SSE para notificações servidor-para-cliente (requer ID da sessão)
/mcp	DELETE	Encerra uma sessão
/health	GET	Verificação de saúde do servidor (JSON)

Fluxo da Sessão

1. Inicializar: POST /mcp com solicitação JSON-RPC initialize → obter cabeçalho Mcp-Session-Id
2. Chamar ferramentas: POST /mcp com cabeçalho Mcp-Session-Id + solicitação JSON-RPC tools/call
3. Stream: GET /mcp?sessionId=... para notificações SSE (opcional)
4. Encerrar: DELETE /mcp com cabeçalho Mcp-Session-Id

Ferramentas

Ferramenta	Descrição	Custo
fetch_url	Busca qualquer URL como markdown limpo	$0.001
render_page	Renderiza páginas com muito JavaScript (SPAs, apps React)	$0.005
extract_data	Extrai dados estruturados de mais de 17 tipos de sites	$0.008
research_topic	Pesquisa multi-fonte com citações	$0.02
check_domains	Verifica disponibilidade de nomes de domínio	$0.003
suggest_domains	Gera sugestões de domínios disponíveis	$0.003
parse_document	Converte documentos de escritório (docx/pptx/xlsx/pdf/…) para markdown	$0.005
list_extractors	Lista extratores de dados estruturados suportados	$0.001
health_check	Verifica o status de saúde da API	Grátis
wallet_info	Mostra o endereço da carteira de pagamento	Grátis

Extratores Suportados

Repositórios/perfis do GitHub, pacotes npm, pacotes PyPI, perfis do Twitter/X, perfis/empresas do LinkedIn, vídeos/canais do YouTube, Product Hunt, Hacker News, Reddit, Crunchbase, Wikipedia e mais.

Use list_extractors para ver todos os tipos disponíveis com seus esquemas.

Variáveis de Ambiente

Variável	Obrigatória	Padrão	Descrição
CLAWFETCH_PRIVATE_KEY	Sim*	—	Chave privada Ethereum (prefixada com 0x) para pagamentos x402
CLAWFETCH_BASE_URL	Não	https://api.clawfetch.ai	URL base da API
CLAWFETCH_TRANSPORT	Não	stdio	Transporte: stdio ou http
CLAWFETCH_HOST	Não	0.0.0.0	Endereço de bind do servidor HTTP
CLAWFETCH_PORT	Não	3001	Porta do servidor HTTP
CLAWFETCH_TIMEOUT_MS	Não	60000	Timeout de solicitação em ms
CLAWFETCH_DEBUG	Não	false	Ativa logs de depuração (1 ou true)

* Obrigatória. Mantenha esta chave na sua configuração local; nunca a envie para o site do ClawFetch.

Desenvolvimento

git clone https://github.com/clawfetch/clawfetch-mcp.git
cd clawfetch-mcp
npm install
npm run build
npm test

Licença

MIT