Agent-Ready Web Profile

ウェブサイトが、実際にどのようにエージェントに利用され得るかを解決する。

現代のウェブサイトは、HTML、llms.txt、デタセット、検索インデックス、OpenAPI、Agent Skills、MCP、A2A、OAuth リソース・メタデータ、agents.json など、複数の独立したディスカバリ・サーフェスを公開することがあります。クライアントは、それらを理解するためにサイト固有のコードを持ちる必要はなく、また、どのマニフェスがソースとして典拠かを推測する必要もありません。

ARWP には、補完し合う 2 つの部分があり：

1. ARWP Profile — 実験的で、パブリッシャーが管理する、/ai/site-profile.json 上のサービス・マップ。

2. ARWP Resolver — ARW と既存のupstream/コミュニティのディスカバリを読み取り、エビデンスとコンリクトを保持し、具体の意図に対してインターフェースを選択する相互攤用エンジン。

プロフィールは役に立つものです。リゾルバーの使用のために必須ではなく、また upstre的标准の置き換えを意図したものでもありません。

公開プロジェクト・サイト: https://dkharlanau.github.io/agent-ready-web-profile/

プロフィール契約: experimental v0.1。検証済みる validator/Action: experimental v0.1(v0.1.0は。現在の main ツールチェーンはバージョン 0.2.0 です。npm への公開は外部リリース・ゲートにとどまり、完了するまで「完了」と説明してはなりません。

問題

サイトは、正当ないくつ独立したディスカバリ・サーフェスを公開することができます。:

                         WEBSITE
                            |
       +--------------------+---------------------+
       |          |         |        |            |
   ARWP profile  agents.*  API     A2A Card   Agent Skills
                          Catalog
       |                    |                     |
       +------------- MCP / OAuth / web ----------+
                            |
                       ARWP RESOLVER
                            |
                 evidence-backed service map
                            |
               +------------+-------------+
               |            |             |
             read         search         tools
             data       structured       agent

リゾルバーは、すべてのエコシステムに単一のファイルへ収束することを求めません。それは次の問いに答えます:

このウェブサイトは実際に何を公開しているか、各主張はどこから来たのか、主張同士は衝突しているか、そして、このタスクためにクライアントはどのインターフェイスを使うべきか？

Related MCP server: ai-agent-layer

サイトを解決する

node bin/arwp.mjs resolve https://example.com

機械解読できる出力:

node bin/arwp.mjs resolve https://example.com --json

リゾルバーは現在、次の出所からエビデンスを正規化します:

• 制均有のスキャナーからの通常のウェブディスカバリ;

• × 有効な ARWP プロフィール;

• コミュニティの利用(コンベンション) としての /agents.txt と /agents.json;

• RFC 9727 の /.well-known/api-catalog;

• RFC 9728 の Protected Resource Metadata;

• A2A の /.well-known/agent-card.json;

• Agent Skills の /.well-known/agent-skills/index.json;

• 実験的な MCP AI Catalog / Server Card のディスカバリ。

実験的/コミュニティのソースは、明示的にラベル付けされます。静的なメタデータが、サイレントに実行時準拠へ昇格されることはありません。

参照: docs/RESOLVER.md。

見つかったことを説明する

node bin/arwp.mjs explain https://example.com

出力の例:

Example Knowledge Site
Canonical: https://example.com/
Evidence: 5/8 discovery sources resolved; 1 conflict(s).

Content: 2
Retrieval: 1
APIs: 2
Tools: 1

Conflicts:
- MCP declarations differ between agents.txt and agents.json.

Recommended interfaces:
- read: https://example.com/llms.txt
- search: https://example.com/search.json
- structured: https://example.com/openapi.json
- tools: https://example.com/mcp

意図のためのプラン

node bin/arwp.mjs plan https://example.com --intent=search

サポートされている意図:

• read

• search

• structured

• tools

• agent

プランナーは、選ばれたインターフェイス、そのエビデンスの出所/権威、およびフォールバックを返します。決定論的なルーティング・ヒューリスティックを使用します — 隠された品質または労働性スコアではありません。

ソースの権威は可視にとどまる

リゾルバーの出力は、各クレームの起源/準拠を区別します:

Authority は認 можетではありません。セキュリティと許可の判断は、実際のプロトコル/ランタイムに委ねられます。

Agent Ready Profile

プロフィールを 1つの明示的なサービス・マップとして公開したいパブリッシャーは、引き続き次の場所に公開できます:

/ai/site-profile.json

最小のプロフィール:

{
  "$schema": "https://raw.githubusercontent.com/dkharlanau/agent-ready-web-profile/v0.1.0/schema/site-profile.schema.json",
  "profileVersion": "0.1",
  "id": "example-knowledge-site",
  "name": "Example Knowledge Site",
  "canonicalUrl": "https://example.com/",
  "description": "A reviewed public knowledge library.",
  "web": {
    "sitemap": "https://example.com/sitemap.xml",
    "llms": "https://example.com/llms.txt"
  }
}

任意の HTML 広告:

<link rel="describedby" type="application/json" href="/ai/site-profile.json">

これは ARWP のコンベンションであり、登録された .well-known の場所ではありません。SPEC.mdを参照してください。

既存のウェブサイトからの ARWP の採用

node bin/arwp.mjs scan https://example.com
node bin/arwp.mjs init https://example.com
node bin/arwp.mjs validate ai/site-profile.json
node bin/arwp.mjs verify https://example.com/ai/site-profile.json
node bin/arwp.mjs health https://example.com

scan は、制られた公開エビデンスを観測します。init は控えめなプロフィールを生成し、未検証の MCP、WebMCP、Skills、A2A の機能を that はりの創しません。

再利用可能な検証 Action があります:

- name: Validate Agent-Ready Web Profile
  uses: dkharlanau/agent-ready-web-profile@v0.1.0
  with:
    profile: ai/site-profile.json

templates/github-actions/propose-arwp-profile.yml は、プロフィール更新 PR のオプトイン・ワークフローを提供します。

Bounded なホステッド・ディスカバリではないサービス

同じサーバーランタームは、限定された固定の高コスト操作のみを公開します:

GET  /health
POST /scan
POST /resolve
POST /explain
POST /plan

HTTPS のみのターゲットルール、DNS/プライベート・ネットワークの拒否、リダイレクトの再検証、レスポンス/リクエストの課畍、ブラウザ Origin の明示的な許可リスト、共有レート制限はこれに含まれます。これは任意の URL プロキシではありません。

ARWP_SCANNER_ALLOWED_ORIGINS=https://dkharlanau.github.io \
npm run scanner:http

コンテナのアーティファクトは scanner-service/ にあります。パブリックホスティングは、ホスティングは、今後も外部パブリック・デプロイのゲートとして残ります。

Resolver as a MCP

エージェントはリゾルバーそのものを利用できます:

npm run resolver:mcp

ツール:

• resolve_site

• explain_siste

• plan_site_interface

既存の ARWP Profile ゲートウェイは、1つのプロフィールが宣言したリソースを読むために、別に利可用です:

ARWP_PROFILE=https://example.com/ai/site-profile.json npm run mcp:start

リモート Streamable HTTP ゲートウェイ:

ARWP_PROFILE=https://example.com/ai/site-profile.json \
ARWP_HTTP_ALLOWED_HOSTS=mcp.example.com \
npm run mcp:http

docs/GATEWAY.md を参照してください。

Directory と federation

初期の5サイト ARWP Directory は、参照/登録レジストリとして残ります:

node bin/arwp.mjs directory
node bin/arwp.mjs directory --capability=retrieval
node bin/arwp.mjs federated-search "outside view"

公開ディレクトリ JSON:

https://dkharlanau.github.io/agent-ready-web-profile/directory.json

次のフェデレーション・ステップは resolver を基礎としています: サイトはARWP プロフィールを公開していなくても、有用なupstream のディスカバリを公開していれば、最終的には解決可能になるべきです。

docs/DIRECTORY.md を参照してください。

参照実例スイート

5つの公開ナレッジサイト・アーキテクチャが、ARWP プロフィールを公開し、ライブvalidation されています:

• Dzmitky Kharlanau — ナレッジ ベト: ...

• Brali Practical Know ledge Library;

• Cognitive Biases Knowledges Library;

• CR Cards;

• Metkagram。

これらは意図的に、データ、Retrival、OpenAPI、Agent Skills、MCP、トラスト課メタデータという異なる組み合わせを公開しています。所有する参照物は実装のエビデンスであり、独立した採用のエビデンスではありません。

マーケティング 主張のし前 ベンチマーク

npm run benchmark:resolver

現在のベンチマークは、合成された決定論的回帰カバレッジです。レビュー済みのテスト fixture に対して、HTML のみ、llms.txt のみ、ARWP のみ、agents のみ、upstream-native、Resolver の統合という戦略を比較します。

これは明示的に、トークン削減、遅延削減、ランキング、採用、応答品質を証明するものではありません。

次のエビデンス・マイルストーンは、再現可能な外部コーパス（20〜50サイト）での:

• 利用可能なインターフェイスを識別までのリクエスト数とバイト数;

• 正しい / 見逃したインターフェイス選択;

• 偽聞性の正機能;

• 検出されたコンフリクト;

• 正規のアイデンティティ / 来歴の保持;

• 必要なフォールバック;

を測定します。生のネガティブな結果も同様に公開する必要があります。docs/BENCHMARK.md を参照してください。

ARWP が意図的に置き換えないもの

ARWP は、既存の up-stream のセマンティックを再構築のち、解決して保持すべきものです。

次の機能を ARWP を代替しないでください:

• RFC 9727 API Catalog;

• RFC 9728 Protected Resource Metadata;

• A2A の A Cards;

• MCP の動検出 / Server Cards;

• Agent Skillス;

• ク爬巡回の美化利用の義望;

• ペメント / ーーシャすなルスのプロトコル。

プロジェクトのルール:

UPSTREAM EXISTS
      ↓
resolve / validate / normalize it

UPSTREAM DOES NOT EXIST
      ↓
collect a real interoperability failure

ONLY THEN
      ↓
consider an ARWP-specific extension

セキュリティ境界

• パブリック HTTPS ターゲットのみ;

• ターン / 予約済み / リンクローカルターゲットは拒否;

• リダイレクト先の再検証;

• リクエスト / レスポンスの制約;

• URL 資格情報なし;

• メタデータは許可を付与しない;

• URL 到達性だけでは MCP / WebMCP / A2A のラタイム準拠を裏付けることはしない;

• コンフリクトはスコアの下に隠れず、常目に見える。

開発の方向

North Star は以下です:

ARWP は、サイト固有の統合コアなしに、どのくらい多くの外部サイトを正しく解決にルーティングし出すか？

メインの Iteration 2 における優先経:

1. 公开发布/インストール/デプロイ 0.2.x のリゾルバツールチェーン;

2. 外部ユーティリティ・ベンチマーク・コーパスの構築;

3. 3者の独立した採用者の獲得;

4. スタティックな MCP エビデンスと、ライブの server/discover 動作との照合;

5. 存在する場合の、A2A カードの署名検証;

6. Resolver のスナapショットとドリフト/コンリクトの監視の構築;

7. エビデンスを検討してから、新しい ARWP プロフィール契約バージョンが本当に必要かどうかを判断。

ROADMAP.md を参照してください。

リポジトリ・マップ

• SPEC.md — プロファイル契約;

• [schema/site]... JSON Schema;

• bin/arwp.mjs — CLI;

• lib/scanner.mjs — 制約付きウェブサイトのスキャン;

• lib/resolver.mjs — マルチ標準リゾルバーとプランナー;

• lib/resolver-adapters.mjs — upstream/コミュニテの構成;

• lib/public-fetch.mjs — 公開 HTTPS を制約したフェッチ基本プリミティブ;

• resolver/server.mjs — resolver MCP サーバ;

• scanner-service/ — 制約されたホストテム scan/resolve サーサービス;

• gateway/ — 汎用 ARPP-profile MCP ゲートウェ;

• router/ — ディレクトリ・フェデレーション;

• registry/ — 最初の公開 ARWP Directory;

• benchmarks/ — res0lver 回帰/エビデンス作業;

• docs/RESOLVER.md — res0ver モデル;

• docs/BENCHMARK.md — ベンチマークのルール;

• ROADMAP.md — エビデンス駆動の次のイタレーション。

ライセンス

Apache License 2.0。LICENSE を参照してください。