DeepSFetch MCP server

Português | English

Kit de desenvolvimento DeepSFetch

Manual completo: 33 guias passo a passo — API, MCP, SDKs, CLI, coleções, monitores, arquivos, integrações e cobrança.

Colete conteúdo da web para agentes de IA e automações com limites explícitos de créditos.

Este kit reúne clientes JavaScript e Python de código aberto, uma ferramenta de linha de comando (CLI) e a integração n8n para a API hospedada do DeepSFetch. Comece com uma página HTML pública, confira o resultado e conecte aos seus projetos.

O kit contém ferramentas de acesso à API. O motor de coleta e o serviço hospedado não estão incluídos. Para executar os exemplos, você precisa de uma conta e de uma chave de API; as coletas consomem créditos do seu espaço de trabalho. Confira os planos atuais.

Obtenha seu primeiro resultado

Requer Node.js 22 ou superior. Crie uma chave em Chaves de API. Na pasta principal do kit, configure a chave para a sessão atual do terminal e execute o exemplo sem dependências:

PowerShell:

$env:DEEPSFETCH_API_KEY = 'SUA_CHAVE_DEEPSFETCH'
node examples/scrape.mjs https://example.com

macOS / Linux:

export DEEPSFETCH_API_KEY='SUA_CHAVE_DEEPSFETCH'
node examples/scrape.mjs https://example.com

O exemplo envia uma coleta de HTML por HTTP com limite de 3 créditos e troca automática para navegador desativada. Depois acompanha a mesma tarefa até o resultado e imprime o JSON. Esse limite não garante gratuidade nem sucesso da coleta. Páginas que dependem de JavaScript precisam de outra configuração. Consulte primeiros passos para tratar erros e retomar uma tarefa.

Escolha sua integração

A implementação do servidor MCP remoto não está incluída. O node n8n ainda não é verificado pelo n8n. O MCP remoto está no registro oficial. Este kit não anuncia parceria nativa nem motor de coleta para hospedagem própria.

Primeiro uso pela CLI

Depois de instalar a CLI e configurar a chave como mostrado acima:

deepsfetch scrape --file examples/scrape-request.json --wait

A CLI informa a chave de idempotência na saída de diagnóstico. Essa chave identifica a operação para evitar duplicação. Se o resultado do envio for desconhecido, repita a mesma requisição com --idempotency-key AMESMACHAVE. Se já recebeu o ID da tarefa, use deepsfetch job IDDATAREFA --wait para consultar a tarefa existente.

Ferramentas abertas e serviço hospedado

Desenvolvimento local

npm install --ignore-scripts
npm test
npm run check

Para executar os testes Python a partir da pasta principal:

python -m pip install ./packages/deepsfetch-sdk-python
python -m unittest discover -s packages/deepsfetch-sdk-python/tests

Shortened. The full README is on GitHub.