SERP-Scraping für Paperclip-KI-Agenten: Echtzeit-Suchdaten

Paperclip ist eine Open-Source-Orchestrierungsschicht für autonome KI-Unternehmen. Sie definieren ein Unternehmensziel, stellen Agenten in einem Organigramm ein, und Paperclip übernimmt Planung, Delegation, Kostenverfolgung und Governance. Was Paperclip standardmäßig nicht enthält, sind Live-Daten aus dem offenen Web - und genau hier passt die Autom-API.

Dieser Artikel zeigt, wie Sie Automs SERP-Endpoints mit Paperclip-Agenten verbinden, mit konkreten Beispielen für die Workflows, die Ihre Agenten am häufigsten ausführen.

Siehe auch: SERP-Scraping mit OpenClaw für eine No-Code-Alternative mit HTTP-Action-Knoten.

Warum Agenten Live-Suchdaten brauchen

Ein Agent, der auf ein Ziel wie „Top 5 für Ziel-Keywords erreichen" oder „Konkurrenten täglich überwachen" hinarbeitet, kann nicht mit veralteten Daten operieren. Statische Wissens-Cutoffs und gecachte Datensätze erzeugen Pläne, die nicht der Realität entsprechen.

Live-SERP-Daten geben Agenten:

• Aktuelle Rankingpositionen bei Google, Bing und Brave - keine Snapshots von vor Monaten
• Konkurrenzbewegungen in Echtzeit erkannt, nicht in einem Wochenbericht
• Marktsignale aus News-, Shopping- und Video-Ergebnissen für die Content-Strategie
• Frische-Bewusstsein - was heute im Index trendet, nicht letzten Monat

Für ein Paperclip-Unternehmen, dessen Ziel Wachstum oder Marktintelligenz ist, sind SERP-Daten ein erstklassiger Input, keine optionale Anreicherung.

Wie Paperclip-Agenten HTTP-Aufrufe machen

Paperclip-Agenten interagieren mit externen Diensten über Tool Calls. Jeder Agent, der HTTP-Anfragen ausführen kann - OpenClaw, Claude, Codex, ein benutzerdefinierter Bash-Agent - kann die Autom-API direkt aufrufen.

Das empfohlene Muster ist es, Ihren Agenten die API-Oberfläche mit einer SKILLS.md-Datei beizubringen. Paperclip injiziert Skill-Dateien zur Laufzeit, sodass Agenten wissen, welche Tools verfügbar sind, ohne neu trainiert zu werden.

SKILLS.md: Agenten den Umgang mit Autom beibringen

Erstellen Sie eine SKILLS.md in Ihrem Paperclip-Projekt mit folgendem Abschnitt:

## Autom SERP API

Live-Suchmaschinenergebnisse über die Autom-API abrufen. Für Rankings prüfen,
Konkurrenten überwachen oder Content-Signale sammeln.

Authentifizierung: `x-api-key`-Header mit dem Wert aus der `AUTOM_API_KEY`-Env-Var setzen.

### Google Search
POST https://api.autom.dev/v1/google/search
{ "query": "<Anfrage>", "page": 1, "gl": "de", "hl": "de" }
Gibt zurück: organic_results[], pagination, search_parameters

### Google News
POST https://api.autom.dev/v1/google/news
{ "query": "<Thema>", "gl": "de", "hl": "de" }
Gibt zurück: organic_results[] mit date, source, snippet

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

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

Kosten: 1 Credit pro Aufruf. Nur erfolgreiche 200-Antworten werden berechnet.

API-Key einrichten

Generieren Sie einen Autom-API-Key auf app.autom.dev und speichern Sie ihn als Umgebungsvariable:

AUTOM_API_KEY=ihr_key_hier

Heartbeat-gesteuertes Rank-Tracking

Paperclips Heartbeat-System plant Agenten so, dass sie in festen Intervallen aufwachen, ihre Arbeit prüfen und handeln.

Beispiel: SEO-Analyst-Agent läuft alle 8 Stunden

agent: SEO Analyst
runtime: claude
heartbeat: every 8h
goal: Keyword-Rankings verfolgen und Positionsveränderungen > 2 Stellen melden
skills:
  - SKILLS.md

Bei jedem Heartbeat ruft der Agent POST /v1/google/search für jedes Keyword auf, vergleicht Positionen mit dem letzten gespeicherten Ergebnis und erstellt bei signifikanten Rückgängen ein Ticket für den SEO-Manager.

Organigramm-Anwendungsfälle

Content-Team

CMO
 └── SEO-Analyst (heartbeat: 8h)     → Rank-Tracking via Google Search
 └── Redakteur (heartbeat: 4h)       → Themenrecherche via Google News + Autocomplete
 └── Social Manager (heartbeat: 12h) → Trendsignale via Google News

Marktintelligenz-Team

CEO
 └── Research-Analyst (heartbeat: 24h)
       → Konkurrenzpräsenz via Google + Bing + Brave (parallel)
       → Shopping-Daten via Google Shopping
       → Stellenanzeigen via Google Jobs für Recruiting-Signale

Lead-Generierungs-Team

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

{
    "query": "Handwerksrösterei Kaffee",
    "gl": "de",
    "location": "München, Deutschland"
}

Kostenkontrolle pro Agent

Jeder Autom-Aufruf kostet 1 Credit. Paperclips Budget-System erzwingt ein hartes Limit pro Agent und Monat. Wenn ein Agent sein Budget erreicht, stoppt er - keine unkontrollierten Schleifen, keine unerwarteten Rechnungen.

Vollständige API-Oberfläche für Ihre Agenten

Alle Endpoints verwenden denselben x-api-key-Header und kosten 1 Credit pro Aufruf:

API-Key erhalten auf app.autom.dev - vollständige Referenz auf docs.autom.dev. Paperclip auf GitHub mit einem Stern versehen, um dem Projekt zu folgen.