Pianificazione dei flussi di lavoro IA
Documentazione e guida all’integrazione dell’API SERP
Invia una richiesta di attività lato server, autenticati con il tuo account ed esamina lo stato HTTP e quello di ogni attività. Esplora lo stesso modello di integrazione nelle famiglie di dati SEO e marketing.
Raccogli risultati organici, annunci e funzionalità di ricerca nei motori di ricerca, mercati e dispositivi supportati. Usa JSON strutturato, HTML e
specifico della fonte
ricerca.
Richieste di autenticazione e attività
Gli account di produzione utilizzano l'autenticazione HTTP Basic. Crea l'header Authorization sul tuo server usando il login e la password forniti; non inserire le credenziali nel codice del browser né in esempi condivisi.
Per le route POST di raccolta supportate, invia un array di
task objects. Each task contains that route’s inputs; a keyword query, page URL and product identifier are not interchangeable
payload.
// Server-side example; configure your deployment and credentials.
const url = new URL("/v3/serp/google/organic/live/advanced", process.env.DATASEO_API_ORIGIN);
const auth = Buffer.from(`${process.env.DATASEO_LOGIN}:${process.env.DATASEO_PASSWORD}`).toString("base64");
const response = await fetch(url, {
method: "POST",
headers: {Authorization: `Basic ${auth}`, "Content-Type": "application/json"},
body: JSON.stringify([{"keyword": "running shoes", "location_code": 2840, "language_code": "en", "device": "desktop"}])
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
for (const task of data.tasks ?? []) {
if (task.status_code !== 20000) throw new Error(task.status_message);
}
// Use task.result only after checking task status.Check the HTTP status first, then the top-level response and each task status_code. A successful HTTP 200 can still contain task errors; only read task.result after validating the task.
YOUR_CONFIGURED_TOOL_SERVER
Controlla lo stato della risposta
La raccolta di parole chiave richiede una fonte e impostazioni di mercato supportate. Interpreta la concorrenza pubblicitaria come una metrica della ricerca a pagamento e mantieni i volumi di ricerca mensili separati dai punteggi di tendenza normalizzati.
Per ispezionare un URL, inizia con /v3/on_page/instant_pages e un input url. Il rendering nel browser e Lighthouse usano opzioni o route separate e potrebbero richiedere una configurazione aggiuntiva.
Per ottenere risposte ufficiali dei modelli, usa la route supportata llm_responses con user_prompt. Elenca i modelli configurati e mantieni le impostazioni dei modelli quando confronti le risposte.
Le route delle attività in coda restituiscono identificativi per il recupero successivo. Conserva gli identificativi e segui il flusso documentato ready/get per la route selezionata, senza presumere che tutti i prodotti prevedano la stessa modalità di consegna.
Conserva le date e gli orari di raccolta, le impostazioni di input e gli identificatori di origine. I campi mancanti devono rimanere null o assenti; non convertire in zero una metrica non disponibile.
risultati organici, annunci e funzionalità di ricerca sui motori di ricerca, nei mercati e sui dispositivi supportati. Usa
JSON strutturato, HTML e opzioni di raccolta specifiche della fonte per il monitoraggio del ranking e la ricerca competitiva.
Il codice e le risposte del sito web sono a scopo illustrativo. Prima di avviare la raccolta in produzione, la distribuzione selezionata deve verificare lo schema del percorso, l'accesso, le quote, la gestione dei dati e i prezzi per i clienti.
L'applicazione al momento non include un server MCP pubblico verificato né connettori nativi per gli strumenti illustrati qui. Usa un'integrazione HTTP lato server solo dopo aver verificato la fonte e il percorso richiesti.
Convalida una risposta rappresentativa prima di estendere l’uso. Controlla i valori nulli, i tipi di elemento, le unità dei campi, i messaggi di errore e se il risultato risponde alla domanda a cui deve rispondere la tua applicazione.
Evita di inserire credenziali e contenuti sensibili delle richieste nei log. Prima di archiviare osservazioni di produzione, concorda la conservazione, le licenze e gli usi consentiti per la fonte selezionata.
"Articoli recenti sul RAG"
Scegli un percorso di prodotto supportato, configura l’origine della distribuzione e le credenziali, quindi testa una singola attività prima di pianificare un carico di lavoro più ampio. Questo frontend usa dati illustrativi locali e non invia richieste API in tempo reale.
Raccogli risultati organici
risultati, annunci e funzionalità di ricerca sui motori di ricerca, nei mercati e sui dispositivi supportati. Usa opzioni di raccolta specifiche per fonte, in JSON strutturato e HTML, per il monitoraggio delle posizioni