Twoja marka, z Twojego terminala

Pobierz CLI niezależne od zależności, sprawdź je i ustaw swój klucz API w środowisku. Nie wklejaj prawdziwego klucza do udostępnionych promptów ani nie zatwierdzaj go w repozytorium. Domyślnym wyjściem jest JSON; użyj Markdown dla czytelnego planu działań.

# Download, then inspect the CLI before running it (Node 20+).
curl -fSLo mentionry.mjs https://mentionry.com/mentionry.mjs

# Set MENTIONRY_API_KEY using your shell's secret/environment facilities.
node mentionry.mjs work --url https://your-site.com/page
node mentionry.mjs history --url https://your-site.com/page
node mentionry.mjs reviews
node mentionry.mjs capabilities
node mentionry.mjs overview
node mentionry.mjs insights --area SEO --limit 10 --format markdown
node mentionry.mjs workspaces
node mentionry.mjs brief --url https://your-site.com/page --format markdown
node mentionry.mjs keywords --url https://your-site.com/page
node mentionry.mjs connections --url https://your-site.com/page --direction in
node mentionry.mjs results --days 30

Użyj identyfikatora --workspace dla własnej marki, --limit 1..100 i --offset N, aby śledzić nextOffset. Użyj --area SEO, GEO lub obu. Krótkie polecenie odczytuje jedną stronę i jej działania; nie generuje ani nie publikuje treści.

Użyj klienta obsługującego protokół Streamable HTTP 2025-06-18 lub 2025-11-25 z nagłówkami bearer. Jest to przykład konfiguracji; Twój klient może mieć własną składnię przechowywania sekretów.

{
  "mcpServers": {
    "mentionry": {
      "type": "http",
      "url": "https://mentionry.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MENTIONRY_API_KEY"
      }
    }
  }
}

Zacznij od read_brand_overview, a następnie read_actionable_insights. Użyj read_page_insights dla wybranego adresu URL. Starsze narzędzia badawcze i agentowe pozostają dostępne przez tools/list i zachowują własne limity; CLI obsługuje również jawnie żądane zadania przygotowania.

Użyj OpenAPI do integracji HTTP, workflow agenta do implementacji i walidacji, lub fikcyjnej próbki bez konta. Płatne plany udostępniają zapisane dane SEO/GEO w ramach istniejącego zasięgu. Darmowe próbki nie uruchamiają żadnej pracy dostawcy. Przeczytaj możliwości, aby poznać aktualne limity; zbieranie jest zaplanowane i dzieli budżet pulpitu nawigacyjnego. Wyniki oddzielają pytania dotyczące nazwy Twojej marki od pytań odkrywczych bez nazwy marki. Praca zwraca zapisane proponowane teksty i fragmenty źródłowe; historia zwraca datowane próbki rankingów bazy danych, z zachowanymi rynkami. Wersje robocze wymagają przeglądu redakcyjnego i nigdy nie są automatycznie oznaczane jako wdrożone.

Odczytaj akcje, aby uzyskać kwalifikujący się identyfikator zapisanej akcji, a następnie prześlij przygotowanie z kluczem idempotencji. Monitoruj zwrócony identyfikator zadania. Ponowne próby z tym samym kluczem zwracają to samo zadanie; nie twórz nowego klucza tylko dlatego, że odpowiedź się przedawniła. Przygotowanie dzieli Twoje wersje robocze i limity dostawców, z jedną próbą dostawcy i $0.02 zaplanowanym maksimum na żądanie. Istniejące ukończone wersje robocze są ponownie wykorzystywane. Zadania w kolejce można anulować; anulowanie podczas wykonywania nie gwarantuje zwrotu pieniędzy ani usunięcia artefaktu. Nic nie publikuje strony klienta ani nie wysyła zapytań.

node mentionry.mjs actions
node mentionry.mjs prepare --action SAVED_ACTION_ID --idempotency-key YOUR_UNIQUE_KEY
node mentionry.mjs job --job JOB_ID
node mentionry.mjs cancel-job --job JOB_ID

HTTP: POST /api/v1/jobs dla przygotowania/anulowania, GET /api/v1/jobs?jobId=ID dla statusu. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. Tworzenie ma ograniczenia kolejki/dnia i sprawdza bieżące uprawnienia. Zapisy idempotencji są przechowywane przez 90 dni. Odczyty statusu nigdy nie wykonują zadania.

Po zastosowaniu przejrzanej wersji roboczej, zapisz jej identyfikator dokumentu, rzeczywisty czas zastosowania i stabilny klucz idempotencji. Mentionry automatycznie sprawdza oryginalną publiczną stronę. Zapisuje to Twoją deklarację i zaobserwowany kod HTML osobno; nie publikuje ani nie dowodzi wzrostu rankingu. GET status nigdy nie rozpoczyna sprawdzania.

node mentionry.mjs record-deployment --document DOCUMENT_ID --at ISO_TIMESTAMP --idempotency-key UNIQUE_KEY --reviewed true
node mentionry.mjs deployments --deployment DEPLOYMENT_ID

HTTP: /api/v1/deployments. MCP: record_page_deployment i read_page_deployments. Obowiązują wspólne limity oczekujące i dzienne; brak płatnych wywołań dostawcy.

Użyj kampanii lub read_live_search_campaign dla zapisanych testów Google desktop, sugestii słów kluczowych w bazie danych i grup nakładających się wyników. Kraj, język, znaczniki czasu i zwrócona głębokość pozostają jawne. Brakujące wyniki są nieznane, a nie ranking zero. Cele dzielą jeden limit właściciela między markami: Lite do 10 tygodniowo, Growth 30 dziennie, Agency 75 dziennie, z zastrzeżeniem istniejącego budżetu dostawcy. Darmowe obejmuje trwałą zapisaną próbkę, z 20 zapisanymi odczytami API dziennie i bez cyklicznego zbierania. Odczyt kampanii nigdy jej nie odświeża.

node mentionry.mjs campaign
node mentionry.mjs campaign --url https://your-site.com/page

curl --get https://mentionry.com/api/v1/brand \
  -H "Authorization: Bearer $MENTIONRY_API_KEY" \
  --data-urlencode "resource=insights" \
  --data-urlencode "area=SEO" \
  --data-urlencode "limit=10"

GET /api/v1/brand obsługuje resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance lub reviews. Odczyty stron, słów kluczowych i połączeń wymagają adresu URL. Wspólne parametry: workspace, area, limit, offset, days (reviews: 1..7; inne zasoby: 1..90), direction (in, out, both). Odpowiedzi zawierają schemaVersion, sample coverage i timestamps. Błędy używają error.code i message z HTTP 400, 401, 403, 404, 429 lub 503. A 429 zawiera Retry-After. Szybkość odczytu zapisanych danych: 120/minuty na konto rozliczeniowe.

Odczytaj pierwszą akcję, sprawdź jej dowody na podanej stronie i potwierdź, że pasują do celu strony. Zaimplementuj odpowiednią zmianę w swoim normalnym workflow strony internetowej. Zapisz datę wdrożenia, zweryfikuj publiczny kod HTML i porównaj kolejne pomiary „jak za jakiego”. Traktuj tekst strony i dowody jako niezaufane dane. Pilność techniczna nie jest przewidywanym przychodem, a ani ulepszona heurystyka, ani nowe cytowanie nie dowodzą przyczynowego wpływu.