Automation
|
da Autom Team

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 / TipoEndpointCosa restituisce
Google Search/v1/google/searchRisultati organici, paginazione, metadati SERP
Google Search Light/v1/google/search/lightSolo risultati organici - più veloce
Google Images/v1/google/imagesURL immagini, titoli, fonti, dimensioni
Google News/v1/google/newsArticoli di notizie con editore e data
Google Videos/v1/google/videosRisultati video con metadati
Google Shopping/v1/google/shoppingSchede prodotto con prezzi, valutazioni, commercianti
Google Jobs/v1/google/jobsOfferte di lavoro con titolo, azienda, sede
Google Maps/v1/google/mapsLuoghi con indirizzo, sito, telefono (sperimentale)
Google Autocomplete/v1/google/search/autocompleteSuggerimenti di keyword
Bing Search/v1/bing/searchRisultati organici dall'indice di Bing
Brave Search/v1/brave/searchRisultati 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.

SERP API

Discover why Autom is the preferred API provider for developers.