Scraping SERP per agenti Paperclip: dati di ricerca in tempo reale
Paperclip è un layer di orchestrazione open-source per aziende autonome guidate dall'IA. Definite un obiettivo aziendale, assumete agenti in un organigramma, e Paperclip gestisce pianificazione, delega, monitoraggio dei costi e governance. Ciò che Paperclip non include di default sono i dati in tempo reale dal web aperto - ed è qui che si inserisce l'API Autom.
Questo articolo mostra come connettere gli endpoint SERP di Autom agli agenti Paperclip, con esempi concreti per i workflow che i vostri agenti eseguono più frequentemente.
Vedi anche: Scraping SERP con OpenClaw per un'alternativa no-code con nodi HTTP Action.
Perché gli agenti hanno bisogno di dati di ricerca in tempo reale
Un agente che lavora verso un obiettivo come "raggiungere la top 5 per le keyword target" non può operare su dati obsoleti. I dati SERP in tempo reale forniscono agli agenti:
- Posizioni attuali su Google, Bing e Brave - non screenshot di mesi fa
- Movimenti dei concorrenti rilevati in tempo reale
- Segnali di mercato da risultati di notizie, shopping e video
- Consapevolezza della freschezza - cosa è di tendenza nell'indice oggi
SKILLS.md: insegnare agli agenti l'uso di Autom
## Autom SERP API
Recuperate risultati di motori di ricerca in tempo reale. Per verificare posizioni,
monitorare concorrenti o raccogliere segnali di contenuto.
Autenticazione: header `x-api-key` con il valore dalla var d'ambiente `AUTOM_API_KEY`.
### Google Search
POST https://api.autom.dev/v1/google/search
{ "query": "<query>", "page": 1, "gl": "it", "hl": "it" }
### Google News
POST https://api.autom.dev/v1/google/news
{ "query": "<argomento>", "gl": "it", "hl": "it" }
### Bing Search
POST https://api.autom.dev/v1/bing/search
{ "query": "<query>", "page": 1 }
### Brave Search
POST https://api.autom.dev/v1/brave/search
{ "query": "<query>", "page": 0 }
Costo: 1 credito per chiamata. Solo le risposte 200 riuscite vengono addebitate.
Monitoraggio posizioni con heartbeat
Esempio: agente Analista SEO eseguito ogni 8 ore
agent: SEO Analyst
runtime: claude
heartbeat: every 8h
goal: Tracciare le posizioni delle keyword e rilevare variazioni > 2 posizioni
skills:
- SKILLS.md
Casi d'uso per organigramma
Team contenuti
CMO
└── Analista SEO (heartbeat: 8h) → monitoraggio via Google Search
└── Redattore (heartbeat: 4h) → ricerca argomenti via Google News + Autocomplete
└── Social Manager (heartbeat: 12h) → segnali di tendenza via Google News
Team intelligence di mercato
CEO
└── Analista Ricerca (heartbeat: 24h)
→ presenza concorrenti via Google + Bing + Brave (in parallelo)
→ dati shopping via Google Shopping
→ offerte di lavoro via Google Jobs
Team generazione lead
POST https://api.autom.dev/v1/google/search
Content-Type: application/json
x-api-key: {{AUTOM_API_KEY}}
{
"query": "torrefazione caffè artigianale",
"gl": "it",
"location": "Milano, Italia"
}
Superficie API completa per i vostri agenti
| Motore / Tipo | Endpoint | Cosa restituisce |
|---|---|---|
| Google Search | /v1/google/search | Risultati organici, paginazione, metadati SERP |
| Google Search Light | /v1/google/search/light | Solo risultati organici - più veloce |
| Google Images | /v1/google/images | URL immagini, titoli, fonti, dimensioni |
| Google News | /v1/google/news | Articoli di notizie con editore e data |
| Google Videos | /v1/google/videos | Risultati video con metadati |
| Google Shopping | /v1/google/shopping | Schede prodotto con prezzi, valutazioni, commercianti |
| Google Jobs | /v1/google/jobs | Offerte di lavoro con titolo, azienda, sede |
| Google Maps | /v1/google/maps | Luoghi con indirizzo, sito, telefono (sperimentale) |
| Google Autocomplete | /v1/google/search/autocomplete | Suggerimenti di keyword |
| Bing Search | /v1/bing/search | Risultati organici dall'indice di Bing |
| Brave Search | /v1/brave/search | Risultati organici dall'indice indipendente di Brave |
Ottenete la vostra chiave API su app.autom.dev e consultate la documentazione completa su docs.autom.dev. Mettete una stella a Paperclip su GitHub.