walletlink.social

---

接続

REST API と同じクレジットを消費する、8 つのツールを備えたリモート MCP サーバーです。インストールは不要です。

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 のアカウントメニューからキーを作成し、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 のユーザー名を指定すると、その人に紐づいたウォレットが返されます。

---

カバレッジについて、正直に説明します

多くのツールが引用する数値は、自分たちに都合のよいものです。ここでは、重要な数値が2つあります。これらを混同すると、実行できないキャンペーンを計画することになります。

質問	回答
X または Farcaster アカウントを持つウォレットの割合	チェーンごとに16～46％
ウォレットとソーシャルアカウントを照合するツールが通常公開する数値	数％未満

この範囲を左右するのはコレクションよりもチェーンです。Base は Farcaster が利用されているため範囲の上限に位置し、Ethereum は下限に近い位置にあります。チェーンごとの実測値はカバレッジのドキュメントをご覧ください。平均値ではなく、利用するチェーンの数値を使ってください。

アカウントを持っていることと、そのアカウントに連絡できることは別の話です。解決された482,968件のXハンドルのうち、70.1％は有効、19.7％は停止済み、10.2％は誰も使用していない名前です。ハンドルが解決されている場合、照合結果にはその状態が反映されます。

ネットワーク	照合の性質
Farcaster	完全です。すべてのアカウントとそのアドレスを毎日更新します。照合は決定論的であるため、見つからない場合も、情報の欠落ではなく実際の情報です。
X	まず証明を確認し、常にラベルを付けます。Xの照合結果の99.8％超は、Farcasterの検証、オンチェーンのENSレコード、ソーシャル認証を伴うサインイン、手動で検証されたレコードなど、ウォレット所有者自身が公開したリンクです。それ以外は相関によるものであり、証拠の分類でそのようにラベル付けされるため、照合結果から、どのように確認されたかを常に把握できます。表示名、プロフィール、タイミングから推測することはありません。

推測すればカバレッジは高くなります。より少ない人数に連絡するほうが、間違った相手に連絡するよりもよいのです。

---

機能

3つの入力方法	CSV のアップロード、コントラクトのインポート（保有者を自動取得）、またはアドレスの貼り付け
8つのチェーン	Ethereum、Base、Robinhood Chain、Arbitrum、Polygon、Optimism、BNB Chain、HyperEVM。8つすべてのNFTとトークンに対応
優先度スコア	保有量 × log₁₀（Farcaster + X のフォロワー数 + 1）。リーチと保有量を合わせて評価
エージェント検出	既知のAIエージェントのウォレット13,622件以上を検出。所有者が別の旨を表明していない場合にのみフラグを付けます
逆引き	X のハンドルまたはFarcasterのユーザー名からウォレットを検索
パブリックAPI	すべてのパックに含まれ、同じクレジットを消費します。キーはセルフサービスで取得できます
MCP サーバー	/api/mcp に8つのツールを用意。OAuthまたは同じキーを使用し、残高も共通です。MCP レジストリに掲載されています
オンチェーン決済	Base上のUSDCで利用できる $1 のAgentパックを /api/x402/buy で購入できます。アカウントは不要で、ウォレット署名によりキーを復元できます
エクスポート	優先度順に並べた完全なCSV、またはXリストへのインポート用のシンプルなハンドルリスト

---

料金

クレジットパックは一度だけ購入し、マッチ数に応じて消費されます。1マッチとは、ウォレットがXのハンドルまたはFarcasterアカウントに解決されることです。何にも解決されないウォレットの費用はかかりません。クレジットの有効期間は購入から12か月です。サブスクリプションはありません。

パック	価格	マッチ数	用途
Free	$0	30日間のローリング期間ごとに100	実際のリストで試す
Trial	$29	250	1つのリストを1回処理
Campaign	$99	1,500	ローンチまたはエアドロップ
Scale	$299	6,000	複数のリスト、または大規模なリスト1つ
Index	$899	25,000	代理店や継続的な業務

すべてのパックに同じ機能が含まれ、違いは利用できるマッチ数だけです。料金モーダル、チェックアウト、比較ページ、schema.orgのオファーはすべて、lib/packs.ts を唯一の信頼できる情報源として参照します。

---

API、MCP、エージェント向けの経路

同じインデックスにつながる3つの入口で、いずれも同じマッチ残高を利用します。クレジット費用、レート制限、エラーコードを含む完全なリファレンスは 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つのツールを提供し、ベアラーキーまたは OAuth 2.1 接続で利用できます。公式 MCP レジストリには social.walletlink/wallet-identity として掲載されています。アクセストークンがなぜ api_keys の行なのか、サーバーがなぜ独自に課金しないのかといった設計の根拠は、app/api/mcp/route.ts のヘッダーに記載されています。

スキルファイル。 https://walletlink.social/skill.md は、設定ブロックではなく URL から機能をインストールするエージェント向けです。ツール、それぞれの費用、認証方法、結果の読み方を記載しています。ほかのすべてと同じ定数と正式な文言から生成されるため、製品が請求しない価格を記載することはありません。

オンチェーン経路。 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 プリミティブ
バックグラウンドジョブ	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/ は内部資料であり、公開されません。また、運用上のシークレットはプライベートな ops リポジトリに保管されています。

---

はじめに

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

localhost:3000 を開きます。アプリはデータベースなしでも動作しますが、キャッシュ、履歴、API の利用にはデータベースが必要です。.env.example にすべての変数が記載されています。DATABASE_URL を設定すると状態を保持する機能が有効になり、Stripe キーを設定すると決済が有効になります。ID ソースの認証情報は、それぞれの項目の横に記載されています。

コマンド

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> を実行すると、ゲート（palette、design、contrast、og、invariants、figures、height）のいずれかを単独で実行できます。すべてのゲートは package.json に記載されています。

---

コントリビューション

変更はブランチを作成して PR を通じて行い、main に直接反映することはできません。PR テンプレートではドキュメントに関する判断を明記するよう求めており、CI がこれを強制します。公開 API の範囲に触れる PR は、docs-site/ も更新するか、no-docs-needed ラベルを付けない限り失敗します。

規約（文頭のみ大文字の見出し、曲線型アポストロフィ、「onchain」を一語として表記するなど）については、CLAUDE.md を参照してください。

---

セキュリティ

脆弱性は非公開で報告し、公開イシューには投稿しないでください。SECURITY.md に、報告先、対象範囲、テストのルール、報告後の流れが記載されています。推奨する報告方法は、GitHub での非公開報告です。同じ連絡先は、機械向けに /.well-known/security.txt にも公開されています。

---

変更履歴

CHANGELOG.md を参照してください。

---

ライセンス

AGPL-3.0。LICENSE を参照してください。

作者

@starl3xx が 🌠 を添えて作成