assetlens

assetlens

assetlens 为 Agent 提供对现实资产市场公开部分的只读访问权限——首先涵盖农业和能源，之后将拓展至采矿、设备和工业服务。它封装了平台的匿名层级：无需账户、无需令牌，也不会执行任何写入操作。你可以读取入门文档、搜索市场列表、搜索项目、同时对两者执行统一搜索，还可以获取搜索命中项背后的完整公开文档。一个二进制文件同时提供命令行界面和 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 返回一个 ID 对应的完整文档：id、title、text、url 和 metadata（对于列表项，包含其 type、category、pricing_mode、price、availability_type 和 location_address）。未知或格式错误的 ID 会导致上游工具错误——状态码为 404 的 Resource not found.；assetlens 会将其作为错误呈现，而不会虚构结果。

MCP 服务

一个二进制文件提供两种接口。mcp 子命令会启动 stdio MCP 服务：

npx -y @reneturcios/assetlens mcp

MCP 客户端配置：

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

工具

工具	输入	返回内容
getting_started	（无）	面向 Agent 的平台入门文档：运营模式、身份验证层级、常见流程和礼仪。
marketplace_listings_search	query?、category?、maxPrice?、limit?、cursor?	符合筛选条件的公开市场列表，并附带分页游标。
projects_search	query?、limit?、cursor?	符合查询条件的公开项目。
search	query（必填，1–200 个字符）	项目和列表中的统一搜索命中项：仅包含 {id, title, url}。
fetch	id（必填，1–120 个字符）	一个搜索命中项对应的完整公开文档。

未包含的内容

使用委派令牌时，同一平台还会提供更多工具，包括身份识别、创建提案的写入操作和提案列表功能（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。