Photo Scout

エージェント型サービス

エージェント型サービスは、人間のユーザー、自律型エージェント、またはその両方を対象とするマルチサービスプラットフォームです。各サービスは特化した機能を提供し、適切なユーザー向けチャネル、機械向けチャネル、またはその両方を通じて個別に販売できます。

サービスは、次の3つの製品カテゴリのいずれかに属します。

• 人間専用： UI を通じて人が利用するよう設計されており、エージェントが呼び出せるインターフェースは必要ありません。
• エージェント専用： 自律型エージェントが機械向けインターフェースを通じて発見、購入、呼び出しを行うよう設計されています。情報を掲載した製品ページは、人間が利用するための UI ではありません。
• 人間とエージェントの両方： 同じ基盤機能について、利用可能な人間向け UI と機械向けサービスインターフェースの両方を提供します。

カテゴリが示すのは想定ユーザーであり、ウェブサイトや API がたまたま存在するかどうかではありません。API、MCP ツール、A2A サービスは機械向けの通信手段として利用できます。人間向け UI は、それらとは別の製品サーフェスです。

製品の契約要件

公開済みの各サービスは、安定した識別子、独自の提供内容と提供条件、決済手段、サービスレベル情報およびポリシー情報を備えています。要件はカテゴリによって異なります。

• 人間専用サービスには、利用可能な UI と、人間向けのチェックアウトまたは利用権付与のフローが必要です。
• エージェント専用サービスには、機械可読な説明、入出力スキーマ、呼び出し可能な通信手段、機械に適した価格設定と決済が必要です。
• 人間とエージェントの両方を対象とするサービスには、同じサービス識別子に基づき、該当する場合は結果と商取引条件に一貫性を持たせた、完全な両方のサーフェスが必要です。
• 有料の提供は計測され、記録される必要があります。機械からの呼び出しには冪等性と検証可能な領収情報が必要です。人間による取引には注文記録と適切な領収書が必要です。
• データサービスは、表明内容に応じたデータの出所と鮮度を公開します。

エージェントインターフェースを備えるサービスでは、正規の公開マニフェストは次の場所にあります。

https://<service-host>/.well-known/agent-service.json

同じマニフェストは、プラットフォームレジストリで索引付けしたり、互換性のあるディスカバリーネットワーク向けにエクスポートしたりできます。人間専用サービスにはエージェントマニフェストは不要です。

リポジトリ構成

docs/                         Product and system design
examples/                     Example service manifests
schemas/                      Versioned protocol schemas
services/                     Product-specific documentation
src/agentic_services/         Runnable gateway and Web Evidence API
tests/                        API contract and safety tests

初期プロトコルは schemas/service-manifest.schema.json で定義されています。例として examples/weather-risk.service.json を参照してください。

アーキテクチャ

プラットフォームは4つのレイヤーで構成されています。

• サービスレイヤー — 個々のサービスモジュールが所有する、特化した情報製品です。
• ゲートウェイレイヤー — ID、見積もり、決済検証、レート制限、領収情報を担当します。
• レジストリレイヤー — 機能の検索、健全性、評判、機械可読なマニフェストを担当します。
• 決済精算レイヤー — 従量課金、クレジット、サブスクリプション用のアダプターを提供します。

実行フローについては docs/architecture.md を、構築手順については docs/roadmap.md を参照してください。

Niche Discovery については、継続的な収集とエージェント分析の設計を参照してください。 その Niche Manager Agent は、拡張可能なツールレジストリ、メモリ、定期実行、イベント駆動の起動を通じて、自律的な調査とナレッジベースの保守を担います。

設計原則

• エージェント向けサービスはプロトコルを優先します。エージェントは文章を読まずにスキーマから連携できます。
• サービスは特化させます。各サービスは小さな領域を担当し、生データだけでなく有用な結果を返します。
• コアは決済方式に依存しません。商取引条件を安定させつつ、決済手段は交換可能にします。
• 提供内容を検証可能にします。有料取引には注文記録があり、機械による実行にはリクエスト、価格、結果に紐づいた領収情報があります。
• 機械による購入では、安全な自律性を確保します。予算、有効期限、リプレイ保護、冪等性を決定論的なコードで強制します。
• 発見は連合型にします。プラットフォームレジストリは有用ですが、サービスを見つける唯一の手段ではありません。

Web Evidence をローカルで実行する

最初に実行できるサービスは Web Evidence です。OpenAI Responses API とホスト型ウェブ検索を基盤とする、構造化された主張検証 API です。

python3 -m venv .venv
.venv/bin/pip install -e '.[dev]'
cp .env.example .env.local
# Add OPENAI_API_KEY to .env.local
.venv/bin/agentic-services

API は http://localhost:8000 で起動します。主なエンドポイントは次のとおりです。

• POST /web-evidence/v1/claims/verify/quick — $0.02 のクイック検証。
• POST /web-evidence/v1/claims/verify — $0.05 の標準検証。
• POST /web-evidence/v1/claims/verify/deep — $0.12 の詳細検証。
• POST /web-evidence/v1/claims/verify/research — $0.25 の研究グレードの検証。

以前の /v1/services/web-evidence/claims/verify... および /v1/claims/verify... パスも、非推奨の互換性エイリアスとして引き続きサポートされています。

• GET /v1/claims/verifications/{verification_id} — 不変の結果を取得します。
• GET /v1/url-snapshots/{snapshot_id} — スナップショットのステータスとコンテンツハッシュを取得します。
• GET /v1/url-snapshots/{snapshot_id}/content — キャプチャした応答バイト列をそのまま取得します。
• GET /.well-known/agent-service.json — サービスとそのスキーマを検出します。
• GET /.well-known/x402 — x402 で支払い可能なリソース URL を検出します。
• POST /mcp — 無料の検出ツール 1 つと、x402 で有料の検証ツール 4 つを備えた MCP Streamable HTTP サーバーです。
• GET /.well-known/mcp/server.json — MCP Registry のメタデータです。
• POST /a2a — Standard ティアで有料の A2A 1.0 JSON-RPC SendMessage です。
• GET /.well-known/agent-card.json — A2A Agent Card です。
• GET /openapi.json — HTTP コントラクト全体を確認します。
• GET /v1/services — プラットフォームカタログ内のすべてのサービスを一覧表示します。
• GET /llms.txt — エージェント統合の簡潔な手順を確認します。
• GET / — 構造化データを含む、人間向けのランディングページです。ウェブインデックスには robots.txt と sitemap.xml が対応しています。
• POST /v1/quotes — 15 分間有効な、機械可読形式のティア見積もりを作成します。
• GET /v1/orders/{order_id} — 有料注文と、ワンタイム注文トークンを含む署名済みレシートを取得します。
• GET /v1/customer/orders — X-Agentic-Customer-Key を使って、登録済み顧客の注文を一覧表示します。
• POST /v1/receipts/{order_id}/verify — 発行済みレシートのサーバー署名を検証します。
• GET /admin — 売上、OpenAI のコスト、粗利益、個別の注文を確認できる非公開のコマースダッシュボードです。
• GET /v1/admin/services — コマースダッシュボードで利用可能なサービスを一覧表示します。
• GET /v1/admin/summary、GET /v1/admin/orders — X-Admin-Key で認証されるダッシュボード API です。どちらもプラットフォーム全体のレポートと serviceId による絞り込みに対応しています。
• POST /v1/admin/customers — 顧客 API キーを発行します。プレーンテキストは一度だけ返され、保存されるのは SHA-256 ハッシュのみです。

リクエストの例：

curl http://localhost:8000/v1/claims/verify \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: example-claim-1' \
  -d '{
    "claim": "OpenAI publishes an official Responses API reference.",
    "sourcePolicy": "official_only",
    "allowedDomains": ["openai.com"],
    "minimumSources": 1
  }'

リクエストの仕様、エビデンスの保証、予定されている有料サービスのエンドポイントについては、docs/web-evidence-api.md を参照してください。

api.aisoup.net の本番 Docker Compose デプロイについては、deploy/google-cloud-vm.md を参照してください。パブリックゲートウェイでは、記載されているティア価格で Base USDC による x402 および MPP 決済を受け付けます。また、MPP Stripe 経由で、1 回あたり最低 $0.50 のカード／USD 決済にも対応しています。Python サービスは、内部 Bearer 認証情報の背後で引き続き非公開のまま運用されます。

ライブでの公開状況

California C-10 Contractor Check は、人間向けには Stripe Checkout（1レポートあたり$19）を通じて、エージェント向けには有料 HTTP APIとMCP エンドポイント（Base USDCで1チェックあたり$1）を通じて利用できます。Smithery の掲載ページ、公式 MCP Registry の記録、共通 x402Scan ページ上のルートは、一般公開されています。リリース契約と再現可能な検証ゲートは、docs/agent-service-release.mdに記載されています。その他の外部ディレクトリへの掲載と、決済の完了はまだ確認されていません。

Web Evidence は、以下の一般公開された発見経路で公開されています。

• ホスト型 MCP 掲載ページとしての Smithery：impanyu/web-evidence。
• io.github.impanyu/web-evidenceとしての公式 MCP Registry。
• 有料 MCP リソース mcp://api.aisoup.net/verify_claim_quickとしてのOpenX402 Bazaar。
• 4つすべての有料 HTTP ティアと、2つの一般公開スナップショットルートを掲載するx402Scan。
• 有料の検証ルートと、安全にクロールできる一般公開のエビデンス／コマースルートを掲載するMPPScan。
• 一般公開の A2A 1.0 Agent Card を通じたGlobal A2A Registryとオープンソースの A2A Registry API。

リポジトリには、MCP Registry への掲載用の server.json と、将来の Glama への申請用の glama.json も含まれています。ランディングページでは、Schema.org サービスメタデータ、robots.txt、sitemap.xml、OpenAPI、llms.txt、および独立したクローラー向けの well-known マニフェストを公開しています。ディレクトリは、その一般公開された掲載内容を独立して取得できた場合にのみ、公開済みとして扱われます。

api.aisoup.net の URL プレフィックスプロパティは Google Search Console で確認済みで、サイトマップも送信済みです。本番環境では、更新された発見用 URL を参加する検索エンジンに送信できるよう、秘密鍵で保護された IndexNow の所有権確認ファイルも公開しています。検索エンジンへの登録には時間がかかるため、検索結果を一般公開で確認できるまでは完了として扱いません。

ステータス

このリポジトリには、v0 プロトコル、実行可能な階層型 Web Evidence サービス、完全なプロバイダーソースの来歴、未加工および正規化済み SHA-256 ハッシュを含む URL スナップショット、SQLite 永続化、機械可読なディスカバリー、x402/MPP デュアルプロトコル決済ゲートウェイが含まれています。有料の HTTP、MCP、A2A の各実行では、注文、署名済みレシート、詳細な収益・コスト台帳エントリーが作成されます。管理ダッシュボードでは、注文ごとの OpenAI トークンコストと Web Search コスト、粗利益、利益率を確認できます。本番環境での USDC 決済と、MCP、A2A、x402、MPP の公開ディレクトリディスカバリーは検証済みです。MPP Stripe では、分離された 2 アカウントのサンドボックス決済に合格しました。実際のライブモードでのカード決済は、引き続き受け入れ要件です。次のマイルストーンは、エビデンス運用の追加と継続的なディレクトリの健全性監視です。

Niche Manager のランタイムとデプロイメント：運用ガイド。

Photo Scout のエージェント API は https://api.aisoup.net/photo-scout/mcp で公開されています。 無料の list_photo_scout_prices ツールでは、料金と対象範囲を確認できます。有料の discover_photo_spots ツールは、x402 MCP を使用し、Base USDC で 2 ドルです。HTTP エンドポイント は MPP を引き続き提供し、人間向けのウェブサイトでは無料プレビューを利用できます。その公式 MCP Registry レコード は公開状態で検証済みです。Photo Scout は、x402Scan と MPPScan にも、1 回の検索あたり 2 ドルで掲載されています。Smithery の GitHub 認証は完了しており、公開はオーナーのメール認証待ちです。決済の完了は、独立した検証がまだ行われていません。リリースメタデータとAPI ドキュメントを参照してください。