walletlink.social

---

连接

一个提供八种工具的远程 MCP 服务，消耗的额度与 REST API 相同。无需安装：

https://walletlink.social/api/mcp

• Claude，或任何支持 MCP OAuth 的客户端： 将 URL 添加为连接器。首次调用工具时会提示你登录，无需复制密钥。
• Claude Code： claude mcp add --transport http walletlink https://walletlink.social/api/mcp --header "Authorization: Bearer wts_live_YOUR_KEY"
• Cursor： 在 walletlink.social 的账户菜单中创建密钥，然后选择 Add to Cursor。
• 其他客户端： 使用相同的 URL，并在 Authorization: Bearer 标头中提供密钥。任何已登录账户均可免费使用密钥。

列出工具无需凭据。MCP 页面提供配置代码块和连接可访问的内容；文档则提供各客户端的配置。

---

工作原理

Wallet list in (CSV · contract address · paste)
  ├─ Resolve against an index of 4.8M+ wallet identities
  ├─ Farcaster: complete protocol coverage, refreshed daily
  ├─ X handles: attested first, labeled always, never inferred
  ├─ Rank by holdings × follower reach
  └─ Export CSV, or an X list ready to import

反过来也行：提供 X 用户名或 Farcaster 用户名，即可返回与此人关联的钱包。

---

坦诚说明覆盖范围

大多数工具引用的数字，都只挑对自己有利的那个。这里有两个重要数字，把它们混为一谈，会让你规划出无法执行的营销活动。

问题	答案
拥有 X 或 Farcaster 账号的钱包	按链划分为 16-46%
将钱包与社交账号匹配的工具通常公布的数字	个位数百分比

与其说由数据集决定，不如说主要由链决定：Base 位于这个范围的上端，因为 Farcaster 扎根于 Base；Ethereum 则接近下端。各链的实测数据表见覆盖范围文档。请使用你所在链的数据，而不是平均值。

拥有账号和能够联系到账号，是两回事。在已解析的 482,968 个 X 用户名中，70.1% 仍在使用，19.7% 已被暂停，10.2% 则无人持有。只要用户名已解析，匹配结果就会附带这一信息。

网络	匹配性质
Farcaster	完整。涵盖每个账号及其地址，每日刷新。匹配结果是确定性的，因此未匹配到就是确切信息，而非信息缺失。
X	先验证，始终标注。超过 99.8% 的 X 匹配都是钱包所有者自行发布的关联：Farcaster 验证、链上 ENS 记录、经认证的社交登录，或人工验证的记录。其他匹配则通过关联推断，并在其证据类别中明确标注，因此每个匹配都会说明其建立方式。不会根据显示名称、简介或时间推断。

如果我们进行猜测，覆盖率会更高。但联系错人，比联系的人少更糟。

---

功能

三种导入方式	上传 CSV、导入合约（自动获取持有者），或粘贴地址
八条链	Ethereum、Base、Robinhood Chain、Arbitrum、Polygon、Optimism、BNB Chain、HyperEVM；覆盖全部八条链上的 NFT 和代币
优先级评分	holdings × log₁₀(Farcaster + X followers + 1)，综合权衡影响力和持仓
Agent 检测	已知 AI Agent 钱包超过 13,622 个；仅在所有者未声明相反信息时标记
反向查询	通过 X 用户名或 Farcaster 用户名反查钱包
公共 API	每个套餐均包含，消耗相同额度；可自行申请密钥
MCP 服务	在 /api/mcp 提供八种工具，支持 OAuth 或使用相同密钥，共享同一余额；已列入 MCP 注册表
链上支付	可在 /api/x402/buy 使用 Base 上的 USDC 购买 $1 Agent 套餐，无需账户；通过钱包签名找回密钥
导出	按优先级排序的完整 CSV，或用于导入 X 列表的纯用户名清单

---

定价

积分套餐，一次性购买，按匹配数计量。一次匹配是指将一个钱包解析为 X 用户名或 Farcaster 账户；无法解析的钱包不收费。积分自购买之日起有效 12 个月。没有订阅。

套餐	价格	匹配数	适用场景
免费	$0	每滚动 30 天 100 次	在实际列表上试用
试用	$29	250	单次使用一个列表
活动	$99	1,500	发布活动或空投
扩展	$299	6,000	多个列表，或一个大型列表
索引	$899	25,000	代理机构和重复性工作

每个套餐都包含相同的功能；套餐之间只有匹配数不同。lib/packs.ts 是唯一可信来源：定价弹窗、结账页面、比较页面和 schema.org 优惠信息均从中读取。

---

API、MCP 和 Agent 通道

通往同一索引的三种入口，使用同一份匹配额度。完整参考文档（包括额度费用、速率限制和错误代码）见 docs.walletlink.social；README 不会重复这些内容。

REST。 任何已登录账户都可以在账户菜单中自行获取密钥，包括使用免费额度的账户。只有成功解析的钱包才会扣除额度，因此密钥和余额是两个独立的问题。

curl https://walletlink.social/api/v1/wallet/0xd8da...96045 \
  -H "Authorization: Bearer wts_live_YOUR_KEY"

MCP。 https://walletlink.social/api/mcp，通过同一组端点提供 8 个工具，支持 Bearer 密钥或 OAuth 2.1 连接。已在官方 MCP 注册表中登记为 social.walletlink/wallet-identity。设计原理（为什么访问令牌是 api_keys 行，以及为什么服务本身不收费）写在 app/api/mcp/route.ts 的文件头部。

技能文件。 https://walletlink.social/skill.md，适用于从 URL 安装能力而非通过配置块安装能力的 Agent：其中介绍工具、各自的费用、如何进行身份验证，以及如何读取结果。它与其他所有内容一样，由同一组常量和规范句子生成，因此不会引用产品并未收取的价格。

链上通道。 POST /api/x402/buy 支持通过 Base 上的 USDC 购买价值 $1 的 Agent 套餐，无需账户、银行卡或电子邮箱：完成付款后，响应中会附带一个新的 API 密钥。/api/x402/recover 可根据签名挑战，向付款钱包重新发放密钥。

Apify。 Wallet to Twitter & Farcaster Lookup 将 REST API 封装为一个市场 Actor，面向习惯通过浏览而非阅读文档来寻找工具的人。运行免费，并使用调用者自己的密钥，因此消耗的是同一份免费额度和同一组套餐。源代码位于 integrations/apify-actor/。

---

架构

CSV / contract / paste
        ↓
  lib/csv-parser.ts ──── detects wallet + holdings columns
        ↓
  /api/jobs ──────────── creates a job; lib/job-processor.ts runs it in chunks, the client polls
        ↓
  ┌─ social_graph ─────── fresh rows and persisted negatives short-circuit
  ├─ wallet_cache ─────── 7-day TTL, negatives included
  └─ resolution pipeline  identity sources, then optional ENS text records
        ↓
  social_graph ─────────── positives and negatives persisted
        ↓
  ResultsTable ─────────── virtualized, sortable, exportable

特意持久化了否定结果。“已检查，没有发现”也是值得保留的答案，并且这能防止流水线反复付费来重新发现同样的缺失。

---

技术栈

层	技术
框架	Next.js 16、App Router
数据库	Neon PostgreSQL、Drizzle ORM
样式	Tailwind CSS v4
UI	Radix primitives
后台任务	Vercel Cron（/api/jobs/worker）
支付	Stripe
文档	Mintlify，位于 docs.walletlink.social
托管	Vercel

---

项目结构

app/
  api/v1/           public API (wallet, batch, reverse, stats, usage)
  api/developer/    API key management
  api/cron/         scheduled ingest and refresh
  vs/               competitor comparison pages
components/         UI, including ApiKeysModal and DocsChat
lib/                resolution pipeline, chains, plans, rate limiting
docs-site/          published Mintlify docs  ← customer-facing
docs/               internal runbooks        ← never published

docs-site/ 和 docs/ 特意分开。docs/ 存放运维手册，并非 Mintlify 内容根目录。

---

有意公开

本仓库是有意公开的。产品的核心主张是，每条匹配结果都附有其背后证据的类别，且其中没有任何内容是推断得出的；公开代码能让人验证这一主张。同样，哪些内容不公开也是经过刻意安排的：docs/ 属于内部资料，永不发布；运维机密则存放在私有的运维仓库中。

---

开始使用

npm install
cp .env.example .env.local   # fill in what you need
npm run dev

打开 localhost:3000。应用无需数据库即可运行；缓存、历史记录和 API 则需要数据库。.env.example 列出了所有变量：DATABASE_URL 用于启用有状态功能，Stripe 密钥用于启用支付功能，身份来源凭据则列在对应条目旁边。

---

命令

npm run dev            # dev server
npm run build          # production build (typechecks as part of the build)
npm run typecheck      # tsc --noEmit, the faster standalone check
npm run preflight      # every CI gate that needs no database, no Chrome and no secrets
npm run lint           # ESLint
npm run format         # Prettier (CI enforces formatting)

npm run db:push        # refuses; schema changes are hand-written SQL, see CLAUDE.md
npm run db:studio      # Drizzle Studio

npm run check:<guard> 可单独运行一道检查（配色、设计、对比度、og、不变量、图形、高度）；package.json 列出了所有检查项。

---

贡献

所有更改都必须通过分支和 PR 提交，不能直接提交到 main。PR 模板要求明确说明文档处理决定，CI 也会强制执行：如果 PR 修改了公共 API 的范围，却没有同时更新 docs-site/ 或添加 no-docs-needed 标签，则会失败。

请参阅 CLAUDE.md 了解规范，包括项目风格（标题使用句首字母大写、使用弯引号撇号、“onchain” 写作一个词）。

---

安全

请私下报告漏洞，切勿在公开 issue 中报告。SECURITY.md 说明了报告渠道、范围、测试规则以及后续处理；首选渠道是通过 GitHub 私人报告。供机器读取的相同联系方式也发布在 /.well-known/security.txt。

---

更新日志

请参阅 CHANGELOG.md。

---

许可证

AGPL-3.0。请参阅 LICENSE。

作者

由 @starl3xx 用 🌠 制作