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.
Przykładowa rozmowa
Zrób audyt https://example.com/blog/geo pod frazę „co to jest geo” i wypisz trzy poprawki, które dadzą najwięcej.
Zleciłem audyt. Potrwa kilka minut - sprawdzam postęp.
Gotowe: Content Quality Score 61/100. Najwięcej dadzą: odpowiedź w pierwszym zdaniu sekcji o definicji, tabela GEO a SEO i źródła przy danych z badania. Pełny raport: app.citationone.com/…
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.
claude mcp add --transport http citationone https://app.citationone.com/api/mcp \
--header "Authorization: Bearer co_live_..."{
"mcpServers": {
"citationone": {
"url": "https://app.citationone.com/api/mcp",
"headers": { "Authorization": "Bearer co_live_..." }
}
}
}{
"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ędzie | Działanie | Odpowiednik w API |
|---|---|---|
start_audit | Audyt adresu albo wklejonego tekstu (np. szkicu przed publikacją), opcjonalnie z frazą, językiem i projektem. Zwraca numer zadania. | POST /api/v1/audits |
get_audit | Status 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_audits | Ostatnie audyty z wynikami, z filtrem po projekcie, domenie albo statusie. | GET /api/v1/audits |
get_credits | Saldo 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.
mkdir -p ~/.claude/skills/citationone
curl -o ~/.claude/skills/citationone/SKILL.md \
https://app.citationone.com/skills/citationone/SKILL.mdW 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).