Dla agencji i specjalistów SEO

Serwer MCP CitationOne

Zlecaj audyty GEO i czytaj ich wyniki w rozmowie z asystentem AI - w Claude, Cursorze i innych klientach MCP. Ten sam silnik, klucz API i kredyty co w panelu.

Skill dla Claude ↓

Przykładowa rozmowa

Ty

Asystentstart_audit
Asystentget_audit

Podłączenie w minutę

Potrzebujesz klucza API (w panelu: Ustawienia → API) i adresu serwera. Klucz z prawem zlecania audytów pozwala asystentowi je uruchamiać; klucz tylko do odczytu wystarczy do przeglądania wyników.

Adres serwera (Streamable HTTP)
https://app.citationone.com/api/mcp
Claude Code · jedno polecenie w terminalu
claude mcp add --transport http citationone https://app.citationone.com/api/mcp \
  --header "Authorization: Bearer co_live_..."
Cursor · ~/.cursor/mcp.json
{
  "mcpServers": {
    "citationone": {
      "url": "https://app.citationone.com/api/mcp",
      "headers": { "Authorization": "Bearer co_live_..." }
    }
  }
}
Claude Desktop · claude_desktop_config.json, przez mcp-remote
{
  "mcpServers": {
    "citationone": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.citationone.com/api/mcp",
               "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer co_live_..." }
    }
  }
}

Narzędzia dostępne dla asystenta

NarzędzieDziałanieOdpowiednik w API
start_auditAudyt adresu albo wklejonego tekstu (np. szkicu przed publikacją), opcjonalnie z frazą, językiem i projektem. Zwraca numer zadania.POST /api/v1/audits
get_auditStatus w trakcie, a po zakończeniu skrót: CQS na tle średniej top 10, wymiary, 10 najważniejszych zaleceń i link do raportu. Na prośbę pełny wynik z tekstami przed/po.GET /api/v1/audits/{id}
list_auditsOstatnie audyty z wynikami, z filtrem po projekcie, domenie albo statusie.GET /api/v1/audits
get_creditsSaldo kredytów i ostatnie operacje.GET /api/v1/credits/usage

Audyt trwa zwykle 3-8 minut. Asystent zleca go, a potem sam sprawdza postęp co 30-60 sekund.

Zasady działania

Ten sam klucz co w API

Serwer MCP korzysta z kluczy API z panelu. Zakresy klucza działają tak samo, a cofnięcie klucza odcina też asystenta.

1 audyt = 1 kredyt

Audyt zlecony przez asystenta kosztuje tyle samo co w panelu i przez API, z tej samej puli kredytów. Odczyt wyników, listy audytów i salda jest bezpłatny. Trzy pierwsze audyty na nowym koncie są darmowe.

Skrót do rozmowy, pełny wynik na prośbę

Domyślnie asystent dostaje zwięzły skrót, który mieści się w rozmowie. Pełny wynik z tekstami przed/po pobiera wtedy, gdy o niego poprosisz.

Link do pełnego raportu

Każdy wynik zawiera adres raportu w panelu - z wykresami, porównaniem z konkurencją i eksportem do PDF.

Te same limity i zabezpieczenia

Limity zapytań, liczba równoległych audytów i ochrona przed podwójnym zleceniem działają jak w API. Błąd wraca do asystenta jako jedno zdanie z kodem.

Treść strony jako dane

Wyniki cytują tekst z audytowanej strony i stron konkurencji. Serwer nakazuje asystentowi traktować ten tekst jako materiał do analizy.

Skill dla Claude - audyty w pracy agencji

Serwer MCP daje asystentowi narzędzia, a skill CitationOne uczy go, jak z nich korzystać przy pracy dla klientów. Działa w Claude Code, Claude Desktop i claude.ai; w Cursorze wystarczy sam serwer MCP.

  • potwierdza koszt i saldo kredytów przed każdym audytem,
  • sprawdza, czy strona nie była audytowana w ostatnich dniach, zanim wyda kredyt,
  • czyta wynik na tle średniej top 10 Google, a różnice poniżej 5 punktów traktuje jako remis,
  • łączy audyty kilku stron jednego klienta w jedną listę priorytetów z poprawkami dla całego serwisu,
  • porównuje audyty przed i po zmianach,
  • pisze podsumowanie dla klienta według gotowego szablonu.
Claude Code i Claude Desktop - zapis w katalogu skilli
mkdir -p ~/.claude/skills/citationone
curl -o ~/.claude/skills/citationone/SKILL.md \
  https://app.citationone.com/skills/citationone/SKILL.md

W claude.ai spakuj katalog citationone z tym plikiem do ZIP i wgraj go w ustawieniach skilli.

Pobierz skill (SKILL.md) ↓

Klucz API tworzysz w panelu: Ustawienia → API. Szczegóły i pełną listę parametrów znajdziesz w dokumentacji (po angielsku).

Wolisz integrację z własnym kodem? Zobacz API →