UXUS Agent Services: wallet lookup, entity labels, caller ID

Name: UXUS Agent Services: wallet lookup, entity labels, caller ID
Author: Dcroyalty

远程服务

uxus.finance金融数据02 周前更新

代码仓库访问官网

关于 UXUS Agent Services: wallet lookup, entity labels, caller ID

UXUS Agent Services 为 AI Agent 提供按次付费服务，包括钱包与实体查询、风险筛查、网页搜索、抓取和数据处理。部分查询及 MCP 功能可免费使用；付费调用通过 x402 使用 Base 上的 USDC，无需账户或 API 密钥。

主要功能

01查询 Ethereum、Base 和 XRPL 钱包
02解析 ENS 和 Basenames
03实体归属查询和来电识别
04提供风险筛查结论
05付费搜索、抓取和数据处理

适用场景

01查询钱包地址及关联实体
02筛查代币所有者权限风险
03搜索或提取网页信息
04执行钱包拦截名单及来电识别检查

MCP 相关

免费的 `/api/mcp` 端点通过 Streamable HTTP 提供基于免费工具的 MCP 服务。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://uxus.finance/api/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http dcroyalty-uxus https://uxus.finance/api/mcp

Cursor.cursor/mcp.json{"mcpServers":{"dcroyalty-uxus":{"type":"http","url":"https://uxus.finance/api/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"dcroyalty-uxus":{"type":"http","url":"https://uxus.finance/api/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"dcroyalty-uxus":{"type":"http","url":"https://uxus.finance/api/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"dcroyalty-uxus":{"serverUrl":"https://uxus.finance/api/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
page	integer	否	从 1 开始计数的结果页码。可选。
count	integer	否	结果数量，1-20。默认值为 10。
query	string	是	搜索查询。必填。
device	string	否	如果设置，则转发给上游提供方；无法确认它是否会在每个提供方处改变结果。可选。
country	string	否	2 个字母的国家/地区代码。可选。
language	string	否	长度为 2 个或更多字母的语言代码。可选。

详细介绍

UXUS — Agent 服务

面向 AI Agent 的按次付费基础服务，现已上线 uxus.finance。通过 x402 协议在 Base 上使用 USDC 付款——无需账户、API 密钥或注册。只需一个已注资的钱包即可完成全部集成。

服务

端点	价格	提供内容
`POST /api/llm`	$0.01	LLM 补全，5 个模型的回退链
`GET /api/scrape`	$0.01	URL → 清理后的 markdown/text/html
`POST /api/extract`	$0.01	混乱的文本/URL → 符合你架构的 JSON
`POST /api/embed`	$0.01	文本 → 1024 维向量（jina-embeddings-v3）
`GET /api/search`	$0.01	实时网络搜索
`GET /api/risk/pro`	$0.02	一次调用，一个判定：PROCEED / CAUTION / BLOCK + 摘要 + 原因
`GET /api/risk/live/pro`	$0.02	一次调用即可判定代币所有者权限（是否仍可暂停、升级或 Rug Pull？）+ 原因
`GET /api/risk` · `/api/risk/live`	免费	风险评分 + 判定（不含原因/信号）
`GET /api/lookup`	免费	查询 Ethereum、Base 和 XRPL 地址，自动检测链
`GET /api/entity`	免费	实体归属信息——此地址代表什么
`GET /api/resolve`	免费	ENS / Basenames，正向 + 反向解析（已验证正向解析）
`GET /api/callerid`	免费	是否应回复此钱包？（用于 XMTP/Push）
`/api/shield/*`	免费	每位用户的私有钱包屏蔽列表（签名认证）
`GET /api/catalog` · `/openapi.json` · `/llms.txt` · `/.well-known/x402.json`	免费	服务发现
`POST /api/mcp`	免费	基于免费工具的 MCP 服务（Streamable HTTP）

每个风险/判定响应都包含 disclaimer：这是基于公开数据（OFAC SDN 名单、社区诈骗注册表、链上读取）的开发者级筛查，不构成法律或合规建议。

数据

制裁数据仅来自一个来源：bad_addresses 中的 OFAC SDN 名单（source='ofac'），由 /api/cron/refresh-lists 每日刷新（设有保护机制——上游返回 0 个地址时会中止，而非清空表）。lib/entity.ts 是唯一会关联此名单的位置。命中非 OFAC 屏蔽名单时，类别为 flagged 而非 sanctioned，且可加入允许名单。
评分采用故障开放策略：若判定所需的数据源不可用且没有命中名单，响应将为 degraded:true / 判定为 CAUTION，绝不会是 PROCEED。

开发

npm install
npm run dev        # http://localhost:3000
npm run build

环境变量（Vercel 项目设置）：

变量	必需	用途
`DATABASE_URL`	是	Neon Postgres
`CRON_SECRET`	是	为 `/api/cron/*` 设置访问门槛；Vercel Cron 会以 `Authorization: Bearer` 形式发送此值
`OPENROUTER_API_KEY`	用于 `/api/llm`、`/api/extract`
`JINA_API_KEY`	用于 `/api/embed`
`SERPER_API_KEY` / `BRAVE_API_KEY`	可选	`/api/search`（回退到 DuckDuckGo）
`ETHERSCAN_API_KEY`	可选	钱包历史记录（回退到 Blockscout）
`CDP_API_KEY_ID` / `CDP_API_KEY_SECRET`	用于 x402 结算

脚本：scripts/schema*.mjs（创建表）、scripts/ingest*.mjs（手动加载名单——定时执行路径为 lib/refresh-lists.ts + scripts/ingest-entity.mjs）、scripts/shield-verify.mjs（实时 E2E）、scripts/fix-sanctions.mjs（一次性制裁数据修复，已运行）。