mcpField
I
is-agentic

is-agentic

github.com/vercelテスト・品質31865 回インストール2 日前に更新
リポジトリ

is-agentic について

Is Agenticは公開URLを監査し、エージェント対応度を0～100で採点して、根拠付きの問題点と修正案を提示します。サイト運営者やレビュー担当者は、CLI、読み取り専用API、MCPエンドポイントから利用できます。

主な機能

  1. 01公開URLのエージェント対応度を採点
  2. 02根拠付きの問題点と修正案を提示
  3. 03保存済みレポートをJSONで返却
  4. 04読み取り専用レポートAPIを提供
  5. 05レポートと文書用のMCPツールを提供

活用シーン

  1. 01ウェブサイトのエージェント対応度を評価
  2. 02スキャン結果に基づいて修正の優先順位を決定
  3. 03MCPホストから完了済みレポートを取得

MCP 対応

Is Agenticはhttps://is-agentic.com/mcp にStreamable HTTPのMCPエンドポイントを提供します。MCPクライアントはレポート、方法論、開発者向けドキュメントのツールを呼び出せます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vercel/vercel-plugin --skill is-agentic

インストール後、Claude Code で/is-agenticを入力して読み込まれたか確認します。

同梱ファイルoverlay.yaml

詳細

Is Agentic

Is Agentic は、公開 URL の技術監査を実施し、エビデンスに基づく問題と推奨される修正を添えて、0〜100 のエージェント対応スコアを公開します。以下のインターフェースはすべて公開されており、読み取り専用で無料です。API キーは必要ありません。

スコアを取得する

デフォルトでは、公式 CLI を使用します。保存済みのレポートがあればすぐに返し、存在しない場合はスキャンを開始して完了を待ちます。

npx is-agentic <domain> --json

ターミナル出力を人が読む場合に限り、--json を省略します。

コマンドを実行できない場合は、代わりに読み取り専用 API を使用します。この API がスキャンを開始することはありません。404 は、完了済みのレポートがまだ存在しないことを意味します。

GET https://is-agentic.com/api/v1/report?url=<url-encoded-target>

MCP ホストは Streamable HTTP エンドポイント https://is-agentic.com/mcp に接続して、is_agentic_get_report、is_agentic_get_methodology、または is_agentic_get_developer_docs を呼び出せます。

レポートを読む

JSON レスポンスは PublicScanReport です。

  • score：0〜100 のスコアです。認証が必要な MCP サーバーなど、対象をスコアリングできなかった場合は null になります。スコアが null の場合、その理由は score_label で説明されます。
  • score_breakdown.essential と .recommended：それぞれ earned、available、passing、total を含みます。Essential チェックは最も重要な項目です。サイトの見栄えがよくても、これらに不合格となる場合があります。
  • score_breakdown.bonus：points と positive_signals を含みます。ボーナスは加算要素であり、必須ではありません。ボーナスシグナルの不足を不備として扱わないでください。
  • issues[]：各項目に id、name、tier（essential | recommended | bonus）、result（failed | partial）、details（スキャンで得られたエビデンス）、recommendation（修正方法）が含まれます。
  • report_url：人が読める正式なレポートです。スコアを人に伝える際は、この URL を提示してください。
  • scanned_at：監査の実行日時です。レポートは変更されないスナップショットです。

サイトのスコアを改善する

  1. 改善対象の正確な URL のレポートを取得します。
  2. issues を次の順に確認します。essential の不合格、essential の部分合格、recommended の順です。それ以外がすべて合格している場合を除き、bonus は無視してください。
  3. 各項目の details にはスキャンで確認された内容が記載され、recommendation には変更内容が記載されています。実際のエビデンスに基づいて作成されているため、推奨内容を優先してください。
  4. 修正をデプロイしたら、新しいスコアを取得し、scanned_at を比較して古いスナップショットを参照していないことを確認します（注意事項を参照）。

エラー

エラーは、安定した code と resolution のヒントを含む RFC 9457 application/problem+json 形式です。code に応じて対処してください。

  • invalid_url（400）：公開されている HTTP または HTTPS の URL を指定してください。
  • report_not_found（404）：完了済みのレポートがありません。CLI でレポートを作成するか、https://is-agentic.com/scan/<target> を開いてスキャンを開始し、完了後に再試行してください。
  • rate_limit_exceeded（429）：再試行する前に Retry-After の時間を守ってください。
  • report_temporarily_unavailable（503）：少し待ってから再試行してください。新しいスキャンは開始しないでください。

注意事項

  • レポートは、アクセス時に6時間より古いことが判明した場合にのみ更新されます。修正をデプロイした直後に CLI を再実行しても、同じ保存済みスナップショットが返されます。結論を出す前に scanned_at を確認し、人がすぐに再実行する必要がある場合はレポートページの「Rescan」コントロールを使用してください。
  • レポートがない場合の動作は API と CLI で異なります。API は404を返し、CLI はスキャンを開始して完了を待ちます。状況に応じて使い分けてください。
  • 対象 URL は厳密に区別されます。example.com/docs と example.com は別のレポートになり、クエリー文字列を含む URL も個別のレポートになります。
  • レート制限は IP アドレスあたり60秒間に120リクエストです。
  • トークン消費を抑えて読む場合、コンテンツページと完了済みのレポートは Accept: text/markdown に対応しています。

コメント

Markdown 対応