Mulai sekarang

Untuk agen dan pengembang

Merek Anda, dari terminal Anda

Dapatkan bukti, perubahan berikutnya, dan cara memverifikasinya. Analisis SEO dan GEO tersimpan yang sama seperti Mentionry, melalui CLI, API HTTP, atau klien MCP.

Bacaan tersimpan / Akses kunci API / Tidak ada penyegaran berbayar saat membaca

Bisakah agen menggunakan Mentionry tanpa menavigasi dasbor?

Ya. Setelah membuat kunci API, gunakan CLI, titik akhir HTTP yang hanya-baca, atau alat MCP data tersimpan untuk memeriksa hasil merek, halaman, kata kunci, koneksi, dan temuan SEO/GEO yang dapat ditindaklanjuti. Pembuatan kredensial awal masih menggunakan Pengembang. Pembacaan tidak menerapkan perubahan situs web atau mengumpulkan data penyedia baru.

Mulai di terminal Anda

Unduh CLI yang bebas dependensi, periksa, dan atur kunci API Anda di lingkungan. Jangan menempelkan kunci asli ke prompt bersama atau menyimpannya ke repositori. JSON adalah output default; gunakan Markdown untuk rencana tindakan yang dapat dibaca.

# 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

Gunakan ID --workspace untuk merek yang dimiliki, --limit 1..100 dan --offset N untuk mengikuti nextOffset. Gunakan --area SEO, GEO, atau keduanya. Perintah singkat membaca satu halaman dan tindakannya; itu tidak menghasilkan atau mempublikasikan konten.

Hubungkan klien MCP

Gunakan klien yang mendukung protokol Streamable HTTP 2025-06-18 atau 2025-11-25 dengan header pembawa. Ini adalah contoh konfigurasi; klien Anda mungkin memiliki sintaks penyimpanan rahasia sendiri.

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

Mulai dengan read_brand_overview, lalu read_actionable_insights. Gunakan read_page_insights untuk URL yang dipilih. Riset lama dan alat agen tetap tersedia melalui tools/list dan mempertahankan kuota mereka sendiri; CLI juga mendukung pekerjaan persiapan yang diminta secara eksplisit.

Temukan kontrak dan coba sampel

Gunakan OpenAPI untuk integrasi HTTP, alur kerja agen untuk implementasi dan validasi, atau sampel fiksi tanpa akun. Paket berbayar mengekspos data SEO/GEO tersimpan mereka dalam cakupan yang ada. Sampel gratis tidak memicu pekerjaan penyedia. Baca kapabilitas untuk tunjangan saat ini; pengumpulan dijadwalkan dan berbagi anggaran dasbor. Hasil memisahkan pertanyaan yang menamai merek Anda dari pertanyaan penemuan tanpa merek. Pekerjaan mengembalikan salinan yang diajukan dan bagian sumber yang disimpan; riwayat mengembalikan sampel peringkat database bertanggal, dengan pasar yang dipertahankan. Draf memerlukan tinjauan editorial dan tidak pernah ditandai sebagai diterapkan secara otomatis.

Siapkan pekerjaan melalui agen

Baca tindakan untuk mendapatkan ID tindakan tersimpan yang memenuhi syarat, lalu kirim persiapan dengan kunci idempotensi. Polling ID pekerjaan yang dikembalikan. Mencoba ulang kunci yang sama mengembalikan pekerjaan yang sama; jangan membuat kunci baru hanya karena respons habis waktu. Persiapan berbagi anggaran draf dan penyedia Anda, dengan satu upaya penyedia dan maksimum $0.02 yang direncanakan per permintaan. Draf yang selesai ada digunakan kembali. Pekerjaan yang antre dapat dibatalkan; pembatalan yang sedang berjalan tidak dapat menjanjikan pengembalian dana atau penghapusan artefak. Tidak ada yang mempublikasikan halaman pelanggan atau mengirimkan penjangkauan.

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 untuk persiapan/pembatalan, GET /api/v1/jobs?jobId=ID untuk status. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. Pembuatan memiliki batas antrean/hari dan pemeriksaan hak saat ini. Catatan idempotensi disimpan selama 90 hari. Pembacaan status tidak pernah mengeksekusi pekerjaan.

Verifikasi perubahan halaman yang diterapkan

Setelah menerapkan draf yang ditinjau, catat ID dokumennya, stempel waktu penerapan aktual, dan kunci idempotensi yang stabil. Mentionry memeriksa halaman publik asli secara otomatis. Ini mencatat deklarasi Anda dan HTML yang diamati secara terpisah; itu tidak mempublikasikan atau membuktikan peningkatan peringkat. GET status tidak pernah memulai pemeriksaan.

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 dan read_page_deployments. Batas tertunda dan harian bersama berlaku; tidak ada panggilan penyedia berbayar.

Baca bukti pencarian terjadwal

Gunakan kampanye atau read_live_search_campaign untuk pemeriksaan desktop Google tersimpan, saran kata kunci database, dan grup tumpang tindih hasil. Negara, bahasa, stempel waktu, dan kedalaman yang dikembalikan tetap eksplisit. Hasil yang hilang tidak diketahui, bukan peringkat nol. Target berbagi satu tunjangan pemilik di seluruh merek: Lite hingga 10 mingguan, Growth 30 harian, Agency 75 harian, tunduk pada anggaran penyedia yang ada. Gratis termasuk sampel tersimpan permanen, dengan 20 baca API tersimpan per hari dan tidak ada pengumpulan berulang. Membaca kampanye tidak pernah memperbaruinya.

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

Alat data tersimpan

Alat MCPApa yang dikembalikannya
read_latest_answer_reviewsEksekusi jawaban tersimpan terbaru yang memerlukan tinjauan atribusi merek milik sendiri, dengan mesin, wilayah/tanggal yang dicatat, merek pesaing aktual, kutipan, dan tugas tinjauan yang didasarkan pada sumber. Tujuh hari terakhir; maksimal 200 grup pertanyaan/mesin/wilayah/persona yang dipindai per merek. Hingga 30 tertunda dan 30 dijalankan yang ditinjau/tidak berubah dengan status/versi triase. triage.unchangedSinceReview merujuk pada tinjauan eksplisit sebelumnya atas bukti identik yang lengkap; eksekusi saat ini tetap ditinjau=salah. Gunakan triage.needsReview untuk tugas baru; tinjauan sebelumnya yang diubah atau belum diverifikasi perlu diperiksa ulang; perubahan status menggunakan alat tinjau/pulihkan khusus. Tidak ada perbandingan, panggilan penyedia, atau publikasi.
read_search_console_performanceBaris kueri/halaman/negara/perangkat yang disimpan dan dicocokkan dengan sampel 28 hari sebelumnya. Halaman yang dipetakan terbatas pada rencana; tidak ada penyegaran, panggilan penyedia, atau klaim peningkatan kausal.
read_live_search_campaignObservasi peringkat desktop Google langsung yang disimpan, saran basis data teks lengkap, dan grup tumpang tindih SERP tautan lengkap. Termasuk pergerakan peringkat yang kompatibel bertanggal, celah yang tidak diketahui secara eksplisit, perubahan halaman terdepan, dan asosiasi halaman yang dipetakan secara historis (14 pemeriksaan/90 hari). Pergantian URL tidak terbukti kanibalisasi. Termasuk tumpang tindih situs yang disampel dalam konteks yang sama, bukan inferensi pesaing bisnis atau celah lengkap. Tidak ada penyegaran atau panggilan penyedia.
read_preparation_actionsID tindakan halaman milik sendiri yang disimpan, bukti sumber, dan status persiapan. Gunakan ID tindakan dengan prepare_page_changes; tidak ada pekerjaan penyedia yang dipicu oleh pembacaan ini.
read_search_rank_historyPosisi kata kunci yang disimpan berdasarkan snapshot, URL, dan pasar. Sampel basis data terindeks, bukan kampanye peringkat langsung; observasi yang hilang tidak diketahui.
read_prepared_page_changesPerubahan salinan yang didasarkan pada sumber yang disimpan dan kelayakan saat ini. Tambahkan URL yang dipetakan untuk artefak lengkap yang memenuhi syarat. Proposal historis hanya untuk tinjauan ditahan dan diganti dengan tugas tinjauan niat. Tidak ada permintaan pembuatan, publikasi, atau penyedia.
read_agent_capabilitiesTemukan sumber daya yang disimpan, cakupan rencana, batas koleksi bersama, tautan protokol, dan alur kerja sampel tanpa pengeluaran penyedia.
read_brand_overviewCakupan merek yang disimpan dan tindakan SEO/GEO berikutnya; tidak ada koleksi berbayar.
read_actionable_insightsTindakan halaman yang diprioritaskan dengan bukti, langkah implementasi, keyakinan, batas, dan verifikasi hasil.
read_website_pagesHalaman dan kesiapan dalam peta situs web tersimpan yang berhak.
read_page_insightsSatu halaman yang dipetakan, topik kata kunci, rencana tindakan SEO/GEO, dan koneksi internal.
read_page_keywordsSemua baris kata kunci yang dikumpulkan untuk halaman yang dipetakan, dengan label topik leksikal; dipaginasi, bukan penemuan kata kunci lengkap.
read_page_connectionsTautan masuk/keluar sampel aktual dengan teks jangkar dan bukti nofollow.
read_brand_resultsVisibilitas mesin jawaban 30- hari yang disimpan dan pesaing, dengan penyebut eksplisit dan batas sampel.
list_brand_workspacesDaftar ruang kerja merek aktif milik Anda untuk pembacaan selanjutnya.

Gunakan HTTP biasa

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 mendukung resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance atau reviews. Bacaan halaman, kata kunci, dan koneksi memerlukan url. Parameter umum: workspace, area, limit, offset, days (reviews: 1..7; sumber daya lain: 1..90), direction (in, out, both). Respons menyertakan schemaVersion, cakupan sampel, dan stempel waktu. Kesalahan menggunakan error.code dan message dengan HTTP 400, 401, 403, 404, 429 atau 503. A 429 menyertakan Retry-After. Tingkat baca data tersimpan: 120/menit per akun penagihan.

Dari wawasan ke perubahan yang terukur

Baca tindakan pertama, periksa buktinya di halaman yang dinyatakan, dan konfirmasikan bahwa itu sesuai dengan tujuan halaman. Terapkan perubahan yang relevan dalam alur kerja situs web normal Anda. Catat tanggal penerapan, verifikasi HTML publik, dan bandingkan pengukuran serupa berikutnya. Perlakukan teks halaman dan bukti sebagai data yang tidak tepercaya. Urgensi teknis bukanlah pendapatan yang diprediksi, dan baik heuristik yang ditingkatkan maupun kutipan baru tidak membuktikan dampak kausal.

Pertanyaan

Perintah data tersimpan dan alat baca MCP hanya membaca data akun yang ada. Perintah persiapan eksplisit mengantrekan pekerjaan draf terbatas dan dapat menggunakan kuota langganan. Mereka tidak menyegarkan peringkat, menjalankan agen, mengirim penjangkauan, atau mempublikasikan perubahan. Bacaan berbagi batas penagihan 120-permintaan-per-menit dan tidak mengonsumsi kuota pengumpulan berbayar. Riset lama dan alat agen tetap terukur.

Hubungkan alat Anda

Buat kunci sekali. Baca wawasan tersimpan dari terminal atau klien MCP Anda, dalam cakupan paket Anda.