Serwer MCP
Analiza tonu, czytelności, AI-slop i semantycznego SEO bezpośrednio w Cursor, Claude Desktop i innych klientach MCP. Ten sam token, te same budżety.
"url": "https://app.pennao.com/api/mcp"
REST API z opisem OpenAPI, webhooki z podpisem HMAC i serwer MCP. Wszystko, co robisz w panelu, zrobisz też z kodu.
W Ustawienia → Tokeny API wybierz zakresy i projekty. Token zaczyna się od psk_live_ i widzisz go tylko raz.
Wyślij brief z nagłówkiem Idempotency-Key. Odpowiedź 202 zawiera ticket i linki do statusu, treści i zdarzeń.
Po zakończeniu Pennao wysyła article.completed z wynikiem jakości, kosztem i linkiem do treści.
zlecenie.sh
curl -X POST "$PENNAO_URL/v1/articles" \
-H "Authorization: Bearer $PENNAO_TOKEN" \
-H "Idempotency-Key: battery-2026-11-17" \
-H "Content-Type: application/json" \
-d '{
"projectId": "prj_01K7…",
"brief": {
"title": "Czy fotowoltaika z magazynem się opłaca?",
"keywords": { "primary": "opłacalność fotowoltaiki" },
"intent": "commercial"
},
"settings": { "languages": ["pl", "en", "de"], "includeFaq": true }
}'
# 202 Accepted
{ "ticket": "art_01K7…", "status": "queued" }
GET /v1/articles/art_01K7…
{
"ticket": "art_01K7…",
"status": "completed",
"languages": ["en", "de", "nl"],
"qualityScore": 91,
"costUsd": 0.11,
"links": {
"content": "…/v1/articles/art_01K7…/content",
"events": "…/v1/articles/art_01K7…/events"
}
}
hooks.js
import { createHmac, timingSafeEqual } from 'node:crypto';
// Pennao-Signature: t=<unix time>,v1=<hex HMAC-SHA256 of "t.body">
export function verify(body, header, secret, toleranceSec = 300) {
const parts = (header ?? '').split(',').map((p) => p.split('='));
const t = parts.find(([k]) => k === 't')?.[1];
if (!t || Math.abs(Date.now() / 1000 - Number(t)) > toleranceSec) return false;
const expected = createHmac('sha256', secret).update(`${t}.${body}`).digest();
return parts.some(([k, v]) =>
k === 'v1' && /^[0-9a-f]{64}$/.test(v) && timingSafeEqual(expected, Buffer.from(v, 'hex')),
);
}
Błędy w formacie application/problem+json, paginacja kursorem i limity zwracane jako 429 z Retry-After. Pełna lista w interaktywnej dokumentacji.
/v1/articles
nowe zlecenie, odpowiedź 202 z ticketem
/v1/articles/{ticket}
status, etap, postęp, koszt i wynik jakości
/v1/articles/{ticket}/events
postęp na żywo (Server-Sent Events)
/v1/articles/{ticket}/content
Markdown, HTML albo JSON w wybranym języku
/v1/articles/{ticket}/approve-plan
zatwierdzenie planu przed pisaniem
/v1/articles/{ticket}/translations
nowe wersje językowe gotowego tekstu
/v1/validate
kontrola jakości dowolnego tekstu
/v1/webhooks
nowy webhook z sekretem do podpisów
Każde dostarczenie ma nagłówek Pennao-Signature z podpisem HMAC-SHA256 i znacznikiem czasu. Odpowiedź inna niż 2xx w ciągu 10 sekund oznacza ponowienie: do 8 prób z rosnącym odstępem.
article.completedartykuł i jego tłumaczenia są gotowearticle.failedzlecenie zakończyło się błędemarticle.plan_readyplan czeka na zatwierdzeniearticle.cancelledzlecenie anulowanoarticle.revision_readyrewizja fragmentu jest gotowaideas.generatednowe pomysły trafiły do projektuproject.profile_readyagent skończył analizę stronyseo.report_readyraport SEO jest gotowyAnaliza tonu, czytelności, AI-slop i semantycznego SEO bezpośrednio w Cursor, Claude Desktop i innych klientach MCP. Ten sam token, te same budżety.
"url": "https://app.pennao.com/api/mcp"
Kontrola jakości dla tekstów spoza Pennao: LanguageTool, filtr AI-slop, linter SEO, linki i JSON-LD. Wynik w JSON albo jako raport Markdown.
POST /v1/validate
Opis każdego endpointu w formacie maszynowym. Wygeneruj klienta w swoim języku albo zaimportuj go do Postmana i Insomnii.
GET /api/openapi.json
Uprawnienia tokenu to część wspólna jego zakresów i roli osoby, która go utworzyła. Token możesz ograniczyć do wybranych projektów, ustawić mu datę wygaśnięcia i w każdej chwili go unieważnić.
articles:readstatusy, treść, wersje, zdarzenia i walidacjaarticles:writenowe zlecenia, anulowanie, ponowienie, zatwierdzenie planuprojects:read / writeprojekty, profile stron i ustawieniaideas:read / writepomysły na tematy i strategiewebhooks:read / writewebhooki i historia dostarczeńskills:runanaliza tekstu: ton, czytelność, AI-slop, semantyczne SEOZałóż konto, dodaj klucz modelu i utwórz token API. Przykłady w curl, Node.js, Pythonie i PHP znajdziesz w dokumentacji.