Odpalaj audyty przez API lub MCP

Base URL

Wszystkie endpointy działają pod jednym hostem. Żądania i odpowiedzi są w JSON, chyba że zaznaczono inaczej.

https://api.citepulse.ai

Uwierzytelnianie

Dwa tryby dostępu, zależnie od tego, co wywołujesz.

Silnik darmowego audytu (bez klucza)

Endpointy audytu nie wymagają klucza API. Wymagają natomiast poprawnego, doręczalnego adresu email oraz akceptacji Regulaminu i Polityki prywatności w treści żądania, i korzystają ze wspólnej dziennej puli. Jeden darmowy audyt na email i domenę; powtórka dla tej samej strony zwraca płatny upsell. To zabezpieczenie antyspamowe na przebiegu, który realnie kosztuje.

API agencyjne (klucz Bearer)

Endpointy /api/v1 uwierzytelniają się kluczem API agencji wydanym z panelu agencji, dostępnym w planie Scale. Wysyłasz go jako token bearer.

Authorization: Bearer <twój-klucz-api-agencji>

REST API

Uruchom audyt widoczności w AI dla domeny. Zwraca 202 z audit_id do odpytywania, albo 200 z wynikiem (result) inline, gdy świeży wynik jest już w cache (poniżej 24 godzin). Raport PDF trafia też na podany adres email.

curl -X POST https://api.citepulse.ai/api/audit \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "email": "[email protected]",
    "accept_terms": true,
    "industry": "b2b saas"
  }'

# 202 Accepted (świeży przebieg, odpytuj o wynik)
{ "audit_id": "3f2c..." }

# 200 OK (trafienie w cache, poniżej 24h)
{ "audit_id": "3f2c...", "result": { "score": 34, "layers": { ... }, "citations": [ ... ] } }

Kody błędów do obsłużenia: 400 (brak domeny lub email, albo brak akceptacji regulaminu), 409 audit_limit (darmowy audyt już był dla tego email i domeny), 429 quota_exhausted (dzienna pula wyczerpana, odnawia się o północy UTC).

Odpytaj trwający audyt.

curl https://api.citepulse.ai/api/audit/3f2c...

# w trakcie
{ "status": "running", "progress": 45, "message": "Querying Perplexity..." }
# po zakończeniu
{ "status": "done", "result": { ... } }

Ten sam postęp jako Server-Sent Events (SSE), jeśli wolisz strumień od odpytywania.

Ile darmowych audytów zostało w dzisiejszej wspólnej puli.

{ "limit": 30, "used": 12, "left": 18, "resets_at": "..." }

API agencyjne (Bearer)

Odczytaj monitorowanych klientów i ich wyniki. Wymaga klucza API agencji (plan Scale).

curl https://api.citepulse.ai/api/v1/clients \
  -H "Authorization: Bearer <twój-klucz-api-agencji>"

# /source-presence
{ "score": 62, "present": ["g2.com", "reddit.com"], "missing": ["wikipedia.org"], "last_checked": "..." }

Serwery MCP

Dwa serwery Model Context Protocol tylko-do-odczytu pozwalają agentowi AI (Claude, Cursor i podobne) pobierać dane CitePulse bezpośrednio jako narzędzie. Oba są bez uwierzytelniania i tylko do odczytu. Manifest do odkrywania:

Serwer katalogowy: /mcp

JSON-RPC 2.0 przez Streamable HTTP (protokół 2025-06-18). Narzędzia tylko-do-odczytu na zweryfikowanych rekordach marek i AI Trust Score.

Narzędzie	Argumenty	Zwraca
get_brand_record	domain	Rekord kanoniczny: nazwa, opis, usługi, profile, AI Trust Score, status weryfikacji
search_brands	query, min_trust_score?	Pasujące zweryfikowane marki z domeną, nazwą, Trust Score i opisem

curl -X POST https://api.citepulse.ai/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_brand_record","arguments":{"domain":"example.com"}}}'

Aby podłączyć to do klienta MCP, wskaż mu URL:

{
  "mcpServers": {
    "citepulse": { "url": "https://api.citepulse.ai/mcp" }
  }
}

Serwer per-marka: /mcp/:domain

Endpoint per-marka, który udostępnia zatwierdzone fakty danej marki, z odpowiedziami podpisanymi Ed25519.

Narzędzie	Zwraca
get_facts	Zatwierdzone fakty marki (podpisane)
get_pricing	Cennik maszynowo-czytelny
get_policies	Polityki (zwroty, wysyłka gdzie dotyczy)
get_products	Rekordy produktów

Limity i cennik

Darmowe audyty korzystają ze wspólnej dziennej puli i są ograniczone do jednego na email i domenę. Nie ma opłaty per-wywołanie i, na dziś, nie ma rozliczania API opartego na zużyciu. Dla wyników natychmiastowych lub głębszych, oraz do użycia programistycznego na wolumenie, ścieżki płatne to:

• Full Audit, jednorazowy głęboki audyt za $39 (dodaje Claude, rozbicie konkurencji per obszar, bez limitu puli).
• Plany monitoringu, od $89/mo, na bieżące sprawdzanie.
• Scale, $349/mo, który zawiera klucz API agencji, white-label i do 10 domen klientów.