エージェントおよび開発者向け
あなたのブランドをターミナルから
証拠、次の変更、およびそれを検証する方法を取得します。Mentionry と同じ保存済み SEO および GEO 分析を、CLI、HTTP API、または MCP クライアント経由で実行します。
エージェントはダッシュボードを操作せずに Mentionry を使用できますか?
はい。API キーを作成した後、CLI、読み取り専用 HTTP エンドポイント、または保存済みデータ MCP ツールを使用して、ブランドの結果、ページ、キーワード、接続、および実行可能な SEO/GEO の調査結果を検査します。最初の認証情報作成では、まだ開発者を使用します。読み取りはウェブサイトの変更を実装したり、新しいプロバイダーデータを収集したりしません。
ターミナルから開始する
依存関係のない CLI をダウンロードし、検査し、環境に API キーを設定します。実際のキーを共有プロンプトに貼り付けたり、リポジトリにコミットしたりしないでください。JSON はデフォルトの出力です。読み取り可能なアクションプランには Markdown を使用してください。
# 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ブランド所有の場合は--workspace IDを使用し、--limit 1..100と--offset NでnextOffsetをフォローします。--area SEO、GEO、またはその両方を使用します。briefコマンドは1ページとそのアクションを読み取りますが、コンテンツを生成または公開することはありません。
MCPクライアントを接続する
Streamable HTTP 2025-06-18または2025-11-25プロトコルとベアラヘッダーをサポートするクライアントを使用します。これは設定例であり、クライアントには独自のシークレットストレージ構文がある場合があります。
{
"mcpServers": {
"mentionry": {
"type": "http",
"url": "https://mentionry.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_MENTIONRY_API_KEY"
}
}
}
}read_brand_overviewから開始し、次にread_actionable_insightsを使用します。選択したURLにはread_page_insightsを使用します。レガシーリサーチおよびエージェントツールはtools/listを介して引き続き利用可能であり、独自のクォータを保持します。CLIは明示的に要求された準備ジョブもサポートします。
契約を発見し、サンプルを試す
使用する OpenAPI HTTP統合用、 エージェントワークフロー 実装と検証用、または 架空のサンプル アカウントなしで。有料プランは、既存のカバレッジ内で保存されたSEO/GEOデータを公開します。無料サンプルはプロバイダーの作業をトリガーしません。現在の許容量については機能を確認してください。コレクションはスケジュールされており、ダッシュボード予算を共有します。結果は、ブランド名を指定した質問とブランド化されていない発見の質問を分離します。作業は保存された提案されたコピーとソースの抜粋を返します。履歴は日付付きのデータベースランキングサンプルを返します。市場は保持されます。下書きは編集レビューが必要であり、自動的に公開済みとしてマークされることはありません。
エージェント経由で作業を準備する
アクションを読み取って適格な保存済みアクションIDを取得し、次に冪等性キーを指定して準備を送信します。返されたジョブIDをポーリングします。同じキーを再試行すると同じジョブが返されます。応答がタイムアウトしたという理由だけで新しいキーを作成しないでください。準備は、下書きとプロバイダーの許容量を共有し、1つのプロバイダー試行とリクエストあたり$0.02の計画された最大値を使用します。既存の完了した下書きは再利用されます。キューに入れられたジョブはキャンセルできます。実行中のキャンセルは、返金または成果物の削除を保証するものではありません。顧客ページを公開したり、アウトリーチを送信したりするものではありません。
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_IDHTTP: POST /api/v1/jobs(準備/キャンセル用)、GET /api/v1/jobs?jobId=ID(ステータス用)。MCP: prepare_page_changes、read_preparation_job、cancel_preparation_job。作成にはキュー/日制限と現在の権利チェックがあります。冪等性レコードは90日間保持されます。ステータス読み取りはジョブを実行しません。
適用されたページ変更を確認する
レビュー済みの下書きを適用した後、そのドキュメントID、実際に適用されたタイムスタンプ、および安定した冪等性キーを記録します。Mentionryは元の公開ページを自動的にチェックします。これにより、宣言と観察されたHTMLが個別に記録されます。公開やランキングの向上を証明するものではありません。GETステータスはチェックを開始しません。
node mentionry.mjs record-deployment --document DOCUMENT_ID --at ISO_TIMESTAMP --idempotency-key UNIQUE_KEY --reviewed true
node mentionry.mjs deployments --deployment DEPLOYMENT_IDHTTP: /api/v1/deployments。MCP: record_page_deploymentおよびread_page_deployments。保留中および日次制限が共有され、有料プロバイダー呼び出しはありません。
スケジュールされた検索証拠を読む
キャンペーンまたはread_live_search_campaignを使用して、保存されたGoogleデスクトップチェック、データベースキーワードの提案、および結果の重複グループを取得します。国、言語、タイムスタンプ、および返された深度は明示されたままです。結果がない場合は不明であり、ランクゼロではありません。ターゲットはブランド間で1つのオーナー許容量を共有します。Liteは週10まで、Growthは日30まで、Agencyは日75まで、既存のプロバイダー予算の対象となります。無料には、永続的な保存済みサンプル、1日あたり20の保存済みAPI読み取り、および定期的なコレクションはありません。キャンペーンを読むことはそれをリフレッシュしません。
node mentionry.mjs campaign
node mentionry.mjs campaign --url https://your-site.com/page保存済みデータツール
| MCPツール | 返されるもの |
|---|---|
| read_latest_answer_reviews | 最新の保存済み回答実行。ブランド固有の帰属レビューが必要で、エンジン、記録された地域/日付、実際の競合ブランド、抜粋、引用、およびソースに基づくレビュータスクが含まれます。過去7日間。ブランドごとにスキャンされる質問/エンジン/地域/ペルソングループは最大200件。最大30件の保留中および30件のレビュー済み/変更なしの実行(トリアージ状態/バージョン付き)。triage.unchangedSinceReviewは、完全な同一証拠の以前の明示的なレビューを参照します。現在の実行はレビュー済み=falseのままです。triage.needsReviewを新しいタスクに使用してください。変更された、または検証されていない以前のレビューは再確認が必要です。状態の変更には専用のレビュー/復元ツールを使用します。比較、プロバイダー呼び出し、または公開はありません。 |
| read_search_console_performance | 保存された最終的なクエリ/ページ/国/デバイスの行と、過去28日間のサンプルとの一致。プラン制限付きでマッピングされたページ。更新、プロバイダー呼び出し、または因果関係の引き上げ主張はありません。 |
| read_live_search_campaign | 保存されたGoogleデスクトップのライブランキング観測、全文データベースの提案、および完全なリンクSERPオーバーラップグループ。日付付きの互換性のあるランキングの移動、明示的な不明なギャップ、主要ページの変更、および履歴マッピングされたページの関連付け(14回のチェック/90日間)が含まれます。URLの切り替えは、共食いとは証明されません。同じコンテキストでサンプリングされたサイトのオーバーラップが含まれます。競合他社や完全なギャップの推論は含まれません。更新またはプロバイダー呼び出しはありません。 |
| read_preparation_actions | 保存されたブランド固有のページアクションID、ソース証拠、および準備状態。アクションIDをprepare_page_changesで使用してください。この読み取りではプロバイダーの作業はトリガーされません。 |
| read_search_rank_history | スナップショット、URL、および市場別の保存されたキーワード位置。インデックス化されたデータベースサンプルであり、ライブランキングキャンペーンではありません。観測されていないものは不明です。 |
| read_prepared_page_changes | ソースに基づく保存されたコピーの変更と現在の適格性。適格な完全な成果物のためにマッピングされたURLを追加してください。レビューのみの履歴提案は保留され、意図レビュータスクに置き換えられます。生成、公開、またはプロバイダーへのリクエストはありません。 |
| read_agent_capabilities | 保存されたリソース、プランカバレッジ、共有コレクションの天井、プロトコルリンク、およびサンプルワークフローをプロバイダーの費用なしで発見します。 |
| read_brand_overview | 保存されたブランドカバレッジと次のSEO/GEOアクション。有料コレクションはありません。 |
| read_actionable_insights | 証拠、実装手順、信頼度、制限、および結果検証を含む、優先順位付けされたページアクション。 |
| read_website_pages | 権限のある保存されたウェブサイトマップ内のページと準備状況。 |
| read_page_insights | 1つのマッピングされたページ、キーワードトピック、SEO/GEOアクションプラン、および内部接続。 |
| read_page_keywords | レキシカルトピックラベル付きのマッピングされたページ用に収集されたすべてのキーワード行。ページネーションされており、完全なキーワード検出ではありません。 |
| read_page_connections | アンカーテキストとノーフォローの証拠を含む、実際のサンプリングされた着信/発信リンク。 |
| read_brand_results | 30-日間の回答エンジンでの可視性と競合他社の記録。明示的な分母とサンプル制限付き。 |
| list_brand_workspaces | 後で参照するために、所有しているアクティブなブランドワークスペースを一覧表示します。 |
通常のHTTPを使用する
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は、リソース=capabilities、overview、insights、pages、page、keywords、connections、results、workspaces、work、history、actions、campaign、performance、またはreviewsをサポートします。ページ、キーワード、接続の読み取りにはURLが必要です。共通パラメータ: workspace、area、limit、offset、days(reviews: 1..7; その他のリソース: 1..90)、direction(in、out、both)。応答には、schemaVersion、sample coverage、およびタイムスタンプが含まれます。エラーは、error.codeとmessage、およびHTTP 400, 401, 403, 404, 429または503.を使用します。429にはRetry-Afterが含まれます。保存済みデータ読み取りレート: 請求アカウントあたり120/分。
インサイトから測定可能な変化へ
最初のアクションを読み取り、指定されたページでの証拠を検査し、それがページの目的に一致することを確認します。通常のウェブサイトワークフローで関連する変更を実装します。デプロイメントの日付を記録し、公開HTMLを確認し、後続の同様の測定値を比較します。ページテキストと証拠を信頼できないデータとして扱います。技術的な緊急性は予測される収益ではなく、改善されたヒューリスティックや新しい引用も因果関係を証明するものではありません。
よくある質問
保存済みデータコマンドと MCP 読み取りツールは、既存のアカウントデータを読み取るだけです。明示的な準備コマンドは、境界付きドラフトジョブをキューに入れ、サブスクリプションの割り当てを使用できます。それらはランキングを更新したり、エージェントを実行したり、アウトリーチを送信したり、変更を公開したりしません。読み取りは、120- リクエスト/分 の請求アカウント制限を共有し、有料の収集クォータを消費しません。レガシーリサーチおよびエージェントツールは引き続き測定されます。