assetlens

assetlens

assetlens を使うと、エージェントは実世界資産のマーケットプレイスの公開側に読み取り専用でアクセスできます。まず農業とエネルギーを対象とし、今後は鉱業、設備、産業サービスへと拡大していきます。アカウントもトークンも必要とせず、書き込み操作は一切行わないプラットフォームの匿名枠をラップしています。オンボーディングドキュメントの閲覧、マーケットプレイスの掲載情報の検索、プロジェクトの検索、両方を対象とした統合検索の実行、検索結果の背後にある公開ドキュメント全体の取得が可能です。1つのバイナリで、コマンドラインインターフェースと stdio MCP サーバーを提供します。

上流は、JSON-RPC 2.0 で通信するホスト型 MCP エンドポイントです。匿名枠はクライアントあたり毎分60リクエストと記載されています。このツールは各呼び出しをそのまま転送し、結果のエンベロープを展開して（ペイロードは結果のテキストコンテンツ内に JSON として届き、構造化コンテンツにもミラーリングされます）、返された内容を出力します。別のエンドポイントを指定するには EPINU_MCP_URL を設定します。デフォルトでは、記載されている本番エンドポイントが使用されます。

インストール

npx @reneturcios/assetlens search --query ASIC

または、コンテナーイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/assetlens

コンテナーはデフォルトで MCP サーバーとして動作します（下記参照）。CLI として使うには、CLI 引数を渡してください。

CLI

assetlens getting_started
assetlens marketplace_listings_search --query "ASIC repair"
assetlens marketplace_listings_search --category equipment --max-price 3000 --limit 5
assetlens projects_search --query mining
assetlens search --query ASIC
assetlens fetch --id listing:f7edbcad-ecbc-46d0-a8f6-162fc8219089

assetlens --version

すべてのコマンドは上流のペイロードを JSON として出力します（オンボーディングドキュメントはテキストとして出力します）。終了コードは、成功時が 0、実行時エラーまたは上流エラー時が 1、使用方法の誤りが 2 です。ネットワーク呼び出しの前に引数が検証されます。未記載のカテゴリ、指定されていない、または長すぎるクエリや ID、不明なフラグは使用方法の誤りとなり、ネットワークリクエストは行われません。

検索引数は、プラットフォームが公開しているテーブルに厳密に従います。marketplace_listings_search と projects_search では、テーブル上で maxPrice、limit、cursor は省略可能、query（および category）にはその指定がないため、ここではどれも必須ではありません。search では query（1～200文字）が必須で、fetch では id（1～120文字）が必須です。category に指定できるのは product、service、repair_services、equipment、energy のみです。

ツールの戻り値

• marketplace_listings_search は results（掲載情報のリスト。listing_id、title、category、pricing_mode、price — 数値または null —、status、location_address などのフィールドを含みます）、next_cursor（次のページがない場合は null）、使用された limit を返します。
• projects_search は projects を返します。各プロジェクトには project_id、name、summary が含まれます。
• search の結果は意図的に簡潔で、各ヒットには id、title、url のみが含まれます。ID には project:<uuid> または listing:<uuid> のプレフィックスが付くため、プラットフォームのどちら側からのヒットかを判別できます。
• fetch は1つの ID に対応するドキュメント全体を返します。内容は id、title、text、url、metadata（掲載情報の場合は type、category、pricing_mode、price、availability_type、location_address）です。不明な ID または形式が不正な ID は上流ツールのエラーとなり、ステータスコード 404 とともに Resource not found. が返されます。assetlens は結果を捏造せず、エラーとして通知します。

MCP サーバー

1つのバイナリで、両方の機能を提供します。mcp サブコマンドで stdio MCP サーバーを起動します。

npx -y @reneturcios/assetlens mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "assetlens": {
      "command": "npx",
      "args": ["-y", "@reneturcios/assetlens", "mcp"]
    }
  }
}

ツール

ツール	入力	戻り値
getting_started	（なし）	エージェント向けのプラットフォームオンボーディングドキュメント：運用モデル、認証ティア、一般的なフロー、エチケット。
marketplace_listings_search	query?、category?、maxPrice?、limit?、cursor?	フィルターに一致する公開マーケットプレイス掲載情報とページングカーソル。
projects_search	query?、limit?、cursor?	クエリに一致する公開プロジェクト。
search	query（必須、1～200文字）	プロジェクトと掲載情報を対象とする統合検索結果。{id, title, url} のみ。
fetch	id（必須、1～120文字）	検索ヒット1件に対応する公開ドキュメント全体。

含まれない内容

委任トークンを使用すると、同じプラットフォームでさらに多くのツールが利用できます。 その中には、ID の取得、提案を作成する書き込み操作、提案一覧の取得があります （whoami、marketplace_listing_create、project_create、 proposals_list_my、および名前が公開されていないその他のスコープ付きツールのほか、 fetch が上流でラップする projects_get_deep_dive と marketplace_listing_get の呼び出しも含まれます）。プラットフォームは説明文でこれらのツール名を挙げていますが、 引数の表は公開していないため、推測で再構成せず、ここでは省略しています。このパッケージは 提案の作成も、何かを書き込むこともありません。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, fake fetch only — no network
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。