Scraping SERP para agentes Paperclip: dados de busca em tempo real

Paperclip é uma camada de orquestração open-source para empresas autônomas movidas por IA. Você define um objetivo de negócio, contrata agentes em um organograma, e o Paperclip gerencia agendamento, delegação, rastreamento de custos e governança. O que o Paperclip não inclui por padrão são dados em tempo real da web aberta - e é aí que a API Autom se encaixa.

Este artigo mostra como conectar os endpoints SERP da Autom com agentes Paperclip, com exemplos concretos para os fluxos de trabalho que seus agentes executam com mais frequência.

Ver também: Scraping SERP com OpenClaw para uma alternativa sem código usando nós HTTP Action.

Por que agentes precisam de dados de busca em tempo real

Um agente trabalhando em direção a um objetivo como "alcançar o top 5 para palavras-chave alvo" não pode operar com dados desatualizados. Os dados SERP em tempo real dão aos agentes:

• Posições atuais no Google, Bing e Brave - não capturas de tela de meses atrás
• Movimentos de concorrentes detectados em tempo real
• Sinais de mercado de resultados de notícias, shopping e vídeos
• Consciência de frescor - o que está em alta no índice hoje

Como os agentes Paperclip fazem chamadas HTTP

O padrão recomendado é ensinar aos seus agentes a superfície da API usando um arquivo SKILLS.md:

## Autom SERP API

Busque resultados de motores de busca em tempo real. Para verificar posições,
monitorar concorrentes ou coletar sinais de conteúdo.

Autenticação: header `x-api-key` com o valor da var de env `AUTOM_API_KEY`.

### Google Search
POST https://api.autom.dev/v1/google/search
{ "query": "<consulta>", "page": 1, "gl": "br", "hl": "pt" }

### Google News
POST https://api.autom.dev/v1/google/news
{ "query": "<tópico>", "gl": "br", "hl": "pt" }

### Bing Search
POST https://api.autom.dev/v1/bing/search
{ "query": "<consulta>", "page": 1 }

### Brave Search
POST https://api.autom.dev/v1/brave/search
{ "query": "<consulta>", "page": 0 }

Custo: 1 crédito por chamada. Apenas respostas 200 bem-sucedidas são cobradas.

Configurar a chave API

AUTOM_API_KEY=sua_chave_aqui

Rastreamento de posições por heartbeat

Exemplo: agente Analista SEO rodando a cada 8 horas

agent: SEO Analyst
runtime: claude
heartbeat: every 8h
goal: Rastrear posições de palavras-chave e detectar variações > 2 posições
skills:
  - SKILLS.md

Casos de uso por organograma

Equipe de conteúdo

CMO
 └── Analista SEO (heartbeat: 8h)    → rastreamento via Google Search
 └── Redator (heartbeat: 4h)         → pesquisa via Google News + Autocomplete
 └── Social Manager (heartbeat: 12h) → sinais de tendências via Google News

Equipe de inteligência de mercado

CEO
 └── Analista de Pesquisa (heartbeat: 24h)
       → presença de concorrentes via Google + Bing + Brave (em paralelo)
       → dados de shopping via Google Shopping
       → vagas de emprego via Google Jobs para inferir sinais de contratação

Equipe de geração de leads

POST https://api.autom.dev/v1/google/search
Content-Type: application/json
x-api-key: {{AUTOM_API_KEY}}

{
    "query": "torrefador de café artesanal",
    "gl": "br",
    "location": "São Paulo, Brasil"
}

Controle de custos por agente

Cada chamada Autom custa 1 crédito. O sistema de orçamento do Paperclip aplica um limite rígido por agente por mês - sem loops descontrolados, sem faturas surpresa.

Superfície API completa para seus agentes

Obtenha sua chave API em app.autom.dev e consulte a referência completa em docs.autom.dev. Dê uma estrela ao Paperclip no GitHub.