Functies AI content engine Prijzen Vanaf €79/mnd Hoe het werkt 3 simpele stappen Blog SEO tips & guides Contact Stel je vraag Roadmap Wat komt er
Gratis artikel
Home/Voor ontwikkelaars

Content-API en MCP-server

Geen WordPress? Geen probleem. Haal de artikelen die SEO AutoPilot voor je schrijft op in je eigen systeem, of laat je AI-assistent het doen. Eén sleutel, twee voordeuren, hetzelfde abonnement.

Sleutel API Webhook RSS-feed MCP-server Grenzen en fouten

1. Je sleutel

Log in, ga naar Integraties en klik op Nieuwe API-sleutel. De sleutel begint met sap_ en wordt maar één keer getoond. Bewaar hem in de instellingen van je systeem, nooit in de code van een publieke webpagina.

Elke aanroep stuurt de sleutel mee als Bearer-token:

Authorization: Bearer sap_jouw_sleutel

De sleutel werkt zolang je abonnement loopt. Trek je hem in, dan stopt alles direct. Een nieuwe sleutel maken vervangt de oude.

2. De content-API

Basisadres: https://www.seoautopilot.nl/api/v1. Alle antwoorden zijn JSON met een veld success.

MethodePadWat het doet
GET/meJe account: pakket, verbruik deze maand, website-type, aantal artikelen.
GET/articlesLijst van artikelen, nieuwste eerst. Filters: status (draft, scheduled, published), since (ISO-datum), page, per_page (max 100).
GET/articles/{slug}Eén artikel met de volledige HTML, meta-omschrijving, tags en beeld.
POST/articles/{slug}/publishedMeld dat het artikel live staat. Stuur {"url": "https://..."}. SEO AutoPilot zet de status op gepubliceerd en meldt de pagina aan bij de zoekmachines.
GET/feed.xmlDezelfde artikelen als RSS 2.0, met de volledige tekst in content:encoded.

Voorbeeld: nieuwe artikelen ophalen

curl https://www.seoautopilot.nl/api/v1/articles?since=2026-09-01&per_page=20 \ -H "Authorization: Bearer sap_jouw_sleutel"

Antwoord (ingekort)

{ "success": true, "total": 26, "page": 1, "per_page": 20, "articles": [ { "slug": "waarom-google-search-console-je-kansen-al-verraadt", "title": "Waarom Google Search Console je kansen al verraadt", "status": "published", "keyword": "google search console", "category": "SEO", "tags": ["search console", "vindbaarheid"], "summary": "Korte samenvatting van het artikel.", "word_count": 2380, "language": "nl", "created_at": "2026-09-01T11:13:51", "updated_at": "2026-09-01T19:04:50", "public_url": "https://jouwsite.nl/blog/waarom-google-search-console-je-kansen-al-verraadt/", "api_url": "https://www.seoautopilot.nl/api/v1/articles/waarom-google-search-console-je-kansen-al-verraadt" } ] }

Voorbeeld: één artikel met tekst

curl https://www.seoautopilot.nl/api/v1/articles/waarom-google-search-console-je-kansen-al-verraadt \ -H "Authorization: Bearer sap_jouw_sleutel" # In het antwoord staat een blok "content": "content": { "title": "Waarom Google Search Console je kansen al verraadt", "html": "<h2>...</h2><p>...</p>", "meta_description": "Beschrijving voor de zoekresultaten.", "featured_image": "https://www.seoautopilot.nl/...webp" }

De HTML is schoon: koppen, alinea's, lijsten, tabellen en eventueel een FAQ-blok met schema. Beelden staan als volledige URL's, zodat je ze kunt overnemen of laten staan. Zet de tekst in je eigen sjabloon en meld daarna de URL terug.

Voorbeeld: melden dat het live staat

curl -X POST https://www.seoautopilot.nl/api/v1/articles/{slug}/published \ -H "Authorization: Bearer sap_jouw_sleutel" \ -H "Content-Type: application/json" \ -d '{"url": "https://jouwsite.nl/blog/{slug}/"}'

Deze stap is belangrijk. Zonder terugmelding weet SEO AutoPilot niet waar het artikel staat, en kunnen de indexering en de positiemeting niet beginnen.

3. Webhook: een seintje bij elk nieuw artikel

Wil je niet hoeven pollen, zet dan onder Integraties een webhook-URL (https). Je krijgt dan een POST bij elk nieuw, gewijzigd of gepubliceerd artikel. Het bericht bevat het artikel zonder tekst; haal de tekst op via de API.

HeaderInhoud
X-SAP-Eventarticle.created, article.updated of article.published
X-SAP-Signaturesha256= gevolgd door de HMAC-SHA256 van de body met je webhook-geheim

Handtekening controleren (PHP)

$body = file_get_contents('php://input'); $verwacht = 'sha256=' . hash_hmac('sha256', $body, $webhook_geheim); if (!hash_equals($verwacht, $_SERVER['HTTP_X_SAP_SIGNATURE'] ?? '')) { http_response_code(401); exit; } $bericht = json_decode($body, true); // $bericht['event'] en $bericht['article']['slug']

Handtekening controleren (Node.js)

const crypto = require('crypto'); const verwacht = 'sha256=' + crypto.createHmac('sha256', geheim).update(rawBody).digest('hex'); if (verwacht !== req.headers['x-sap-signature']) return res.status(401).end();

Antwoord met een 2xx-status. Het geheim staat naast je sleutel onder Integraties. Wijzigingen worden elke minuut gecontroleerd, dus een seintje komt hooguit een minuut na de wijziging.

4. RSS-feed

Heeft je systeem een RSS-importeur, dan hoef je niets te bouwen. De feed staat op /api/v1/feed.xml en bevat de laatste 50 artikelen met volledige tekst. De sleutel gaat als Bearer-header mee, dus de feed is nooit openbaar.

curl https://www.seoautopilot.nl/api/v1/feed.xml -H "Authorization: Bearer sap_jouw_sleutel"

5. MCP-server: je AI-assistent doet het werk

MCP is de standaard waarmee AI-assistenten zoals Claude en ChatGPT met een dienst praten. Koppel je SEO AutoPilot-account en je kunt in je assistent vragen: "Welke artikelen staan klaar?", "Geef me het artikel over dakisolatie" of "Meld dat dit artikel live staat op deze URL". De assistent gebruikt dezelfde sleutel en hetzelfde abonnement.

Adres: https://www.seoautopilot.nl/mcp (Streamable HTTP, zonder sessie). Authenticatie via de Authorization-header.

Claude Code

claude mcp add --transport http seo-autopilot https://www.seoautopilot.nl/mcp \ --header "Authorization: Bearer sap_jouw_sleutel"

Claude Desktop, Cursor en andere clients (JSON)

{ "mcpServers": { "seo-autopilot": { "type": "http", "url": "https://www.seoautopilot.nl/mcp", "headers": { "Authorization": "Bearer sap_jouw_sleutel" } } } }

Beschikbare tools

ToolWat het doet
get_accountPakket, verbruik en website-gegevens.
list_articlesArtikelen met status en datum, zonder tekst. Filters: status, since, limit.
get_articleVolledig artikel inclusief HTML.
mark_publishedMeldt een artikel als live op een URL en meldt de pagina aan bij de zoekmachines.

Bewust niet via MCP: artikelen schrijven of plannen. Dat gebeurt in SEO AutoPilot zelf, met de dekkingskaart, de redactie en het maandquotum. De koppeling levert wat er geschreven is, ze schrijft niet.

6. Grenzen en fouten

StatusBetekenis
401Geen of ongeldige sleutel.
402Abonnement niet actief. Log in om de betaling af te ronden.
404Artikel niet gevonden.
429Meer dan 600 aanvragen per uur met één sleutel. Probeer het later opnieuw.

Elke fout heeft een JSON-body met error en een leesbare message. Kom je er niet uit, mail info@seoautopilot.nl of bel. Je krijgt Jos aan de lijn, niet een helpdesk.