Scraping SERP para agentes Paperclip: datos de búsqueda en tiempo real

Paperclip es una capa de orquestación open-source para empresas autónomas impulsadas por IA. Usted define un objetivo empresarial, contrata agentes bajo un organigrama, y Paperclip gestiona la planificación, delegación, seguimiento de costos y gobernanza. Lo que Paperclip no incluye por defecto son datos en vivo de la web abierta - y ahí es donde encaja la API de Autom.

Este artículo muestra cómo conectar los endpoints SERP de Autom con agentes Paperclip, con ejemplos concretos para los flujos de trabajo que sus agentes ejecutan con mayor frecuencia.

Ver también: Scraping SERP con OpenClaw para una alternativa sin código usando nodos HTTP Action.

Por qué los agentes necesitan datos de búsqueda en vivo

Un agente trabajando hacia un objetivo como "alcanzar el top 5 para palabras clave objetivo" o "monitorear el contenido de competidores diariamente" no puede operar con datos obsoletos. Los límites de conocimiento estáticos y los datasets en caché producen planes que no reflejan la realidad.

Los datos SERP en vivo dan a los agentes:

• Posiciones actuales en Google, Bing y Brave - no instantáneas de hace meses
• Movimientos de competidores detectados en tiempo real, no en un informe semanal
• Señales de mercado de resultados de noticias, shopping y videos que informan la estrategia de contenido
• Conciencia de frescura - qué está en tendencia en el índice hoy, no el mes pasado

Cómo los agentes Paperclip hacen llamadas HTTP

Los agentes Paperclip interactúan con servicios externos mediante tool calls. Cualquier agente capaz de realizar solicitudes HTTP puede llamar a la API de Autom directamente.

El patrón recomendado es enseñar a sus agentes la superficie de la API usando un archivo SKILLS.md:

## Autom SERP API

Recupere resultados de motores de búsqueda en vivo. Para verificar posiciones,
monitorear competidores o recopilar señales de contenido.

Autenticación: header `x-api-key` con el valor de la var de env `AUTOM_API_KEY`.

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

### Google News
POST https://api.autom.dev/v1/google/news
{ "query": "<tema>", "gl": "es", "hl": "es" }

### 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 }

Costo: 1 crédito por llamada. Solo las respuestas 200 exitosas se facturan.

Configurar la clave API

Genere una clave API de Autom en app.autom.dev y guárdela como variable de entorno:

AUTOM_API_KEY=su_clave_aquí

Seguimiento de posiciones por heartbeat

Ejemplo: agente Analista SEO ejecutándose cada 8 horas

agent: SEO Analyst
runtime: claude
heartbeat: every 8h
goal: Rastrear posiciones de palabras clave y detectar variaciones > 2 posiciones
skills:
  - SKILLS.md

En cada heartbeat, el agente llama POST /v1/google/search para cada palabra clave, compara posiciones con el último resultado almacenado y crea un ticket para el responsable SEO si se detecta una caída significativa.

Casos de uso por organigrama

Equipo de contenido

CMO
 └── Analista SEO (heartbeat: 8h)     → seguimiento via Google Search
 └── Redactor (heartbeat: 4h)         → investigación via Google News + Autocomplete
 └── Social Manager (heartbeat: 12h)  → señales de tendencias via Google News

Equipo de inteligencia de mercado

CEO
 └── Analista de Investigación (heartbeat: 24h)
       → presencia de competidores via Google + Bing + Brave (en paralelo)
       → datos de shopping via Google Shopping
       → ofertas de empleo via Google Jobs para inferir señales de contratación

Equipo de generación de leads

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

{
    "query": "tostador de café artesanal",
    "gl": "es",
    "location": "Madrid, España"
}

Control de costos por agente

Cada llamada a Autom cuesta 1 crédito. El sistema de presupuesto de Paperclip aplica un límite duro por agente por mes.

Superficie API completa para sus agentes

Obtenga su clave API en app.autom.dev y consulte la referencia completa en docs.autom.dev. Dale una estrella a Paperclip en GitHub para seguir el proyecto.