nansen-wallet-batch — скилл для Claude Code: обзор и установка
Скилл для Claude Code и других агентов, который отправляет список криптокошельков в Nansen Profiler за один запрос. Помогает быстро найти адреса фондов и категорию smart money.
npx skills add nansen-ai/nansen-cli --skill nansen-wallet-batch -a claude-codeЧто делает nansen-wallet-batch
Скилл выполняет пакетное профилирование адресов через команду nansen research profiler batch. Он передаёт список кошельков и сеть, запрашивая метки категорий и баланс токенов. Ошибочные адреса не ломают весь процесс: CLI возвращает текст ошибки в поле .error, поэтому агент просто отсеивает невалидные кошельки. Если баланс не требуется, запрос можно ускорить, исключив параметр balance.
Для работы требуется установленный пакет nansen-cli с исполняемым файлом nansen в PATH. До запуска проверки кошельков необходимо подтвердить доступ через nansen auth status. Авторизация работает либо через переменную NANSEN_API_KEY, либо через сохранённую сессию браузера после nansen login. Без настроенного ключа или активной сессии вызовы завершатся ошибкой, а переключаться на анонимный режим инструкция прямо запрещает.
Каждый вызов API расходует кредиты тарифа или средства через x402 при получении HTTP 402 от сервиса. Команды проверки статуса и nansen account баланс не списывают.
Какие задачи решает
- проверить список блокчейн-адресов на принадлежность к smart money
- найти кошельки венчурных фондов в заданной сети
- получить долларовый баланс токенов сразу для пачки адресов
- отфильтровать невалидные кошельки без падения всей выборки
Примеры запросов агенту
- Проверь адреса
0x111...,0x222...в сетиethereumи оставь только smart money - Запусти пакетный профайлер Nansen для списка адресов без выгрузки балансов
- Сделай профилирование кошельков в сети
ethereumчерезnansen-wallet-batchи покажи фонды
Как установить nansen-wallet-batch
1Через Skills CLI (Vercel)
npx skills add nansen-ai/nansen-cli --skill nansen-wallet-batch -a claude-code2Вручную: положить файлы
~/.claude/skills/nansen-wallet-batch/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/nansen-wallet-batch/
1Через Skills CLI (Vercel)
npx skills add nansen-ai/nansen-cli --skill nansen-wallet-batch -a codex2Вручную: положить файлы
.agents/skills/nansen-wallet-batch/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add nansen-ai/nansen-cli --skill nansen-wallet-batch -a cursor2Вручную: положить файлы
.cursor/skills/nansen-wallet-batch/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install nansen-ai/nansen-cli nansen-wallet-batch2Вручную: положить файлы
.github/skills/nansen-wallet-batch/SKILL.md1Через Skills CLI (Vercel)
npx skills add nansen-ai/nansen-cli --skill nansen-wallet-batch -a gemini-cli2Командой платформы
gemini skills install https://github.com/nansen-ai/nansen-cli --path skills/nansen-wallet-batchВручную: положить файлы
.devin/skills/nansen-wallet-batch/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add nansen-ai/nansen-cli --skill nansen-wallet-batch -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о nansen-wallet-batch
Как установить nansen-wallet-batch в Claude Code?
Выполните команду npx skills add nansen-ai/nansen-cli --skill nansen-wallet-batch -a claude-code.
Что делает скилл nansen-wallet-batch?
Он отправляет пачку кошельков в Profiler через CLI Nansen и возвращает разметку меток с категориями smart_money или fund, а также балансы токенов.
Как скилл обрабатывает недействительные адреса кошельков?
Команда CLI не прерывает работу с фатальной ошибкой: для некорректного адреса возвращается поле .error, что позволяет агенту пропустить его и обработать остальные результаты.
Исходный текст
SKILL.md · MIT
---
name: nansen-wallet-batch
description: "Which of these addresses are smart money? Batch-profile a list in one call."
metadata:
openclaw:
requires:
bins:
- nansen
primaryEnv: NANSEN_API_KEY
install:
- kind: node
package: nansen-cli
bins: [nansen]
allowed-tools: Bash(nansen:*)
---
## Authentication
Browser login requests `nansen:api` for API-key-equivalent account API permissions; existing OAuth/MCP `nansen:read` semantics and separate wallet authorization are unchanged.
Before any research command or loop, require an explicitly selected API key or saved browser session. Run `nansen auth status` first. Its cached/unverified metadata does not prove credential validity or unlocked storage. Cached access-token expiry alone does not mean the session is unusable: the CLI normally renews a selected session automatically during an already-authorized research task, without another consent request or a separate account check. Stop on anonymous selection, invalid authentication state, blocked or uncertain renewal/cleanup, or an actual authentication failure, including rejected or expired refresh authority. Follow the CLI error guidance; use the free `nansen account` check when troubleshooting calls for it. Do not unset a failed key, erase a session or switch to anonymous access to retry.
Use `nansen login` for fresh browser approval within the documented platform scope, or configure a conventional API key. `NANSEN_API_KEY` overrides the saved session. OpenClaw's optional `primaryEnv` mapping preserves configured API-key injection; it is not a required-key gate or proof of authentication. Normal credits and entitlements apply. Login does not purchase credits. Browser login is available in CLI 2.0.0 within the [macOS arm64 preview scope](https://github.com/nansen-ai/nansen-cli/blob/main/docs/browser-login.md#preview-platform-scope).
API keys and browser sessions use the same automatic x402 payment behavior: a supported HTTP 402 challenge can spend funds from the configured wallet under existing wallet authorization, payment policy and spending limits. Each call, including calls in loops, can incur a payment. Authentication, authorization and session-renewal failures never trigger payment; login verification and `nansen account` never pay automatically. Anonymous x402 remains available as a separate paid workflow requiring explicit user intent and payment setup. Do not run this research workflow anonymously or switch to anonymous access after authentication fails.
```bash
ADDRESSES="0xaddr1,0xaddr2,0xaddr3,..." CHAIN=ethereum
nansen research profiler batch --addresses "$ADDRESSES" --chain $CHAIN --include labels,balance
# → .data.{total, completed, results[]: {address, chain, labels[], balance, error}}
# labels[]: {label, category ("smart_money","fund","social","behavioral","others"), kind[]}
# balance: {data[]: {token_symbol, token_amount, price_usd, value_usd}}
```
Check .error per result — invalid addresses return an error message, not a crash. Skip those.
Keep addresses where any label.category == "smart_money" or "fund". Omit balance for faster checks.
© nansen-ai · MIT · nansen-ai/nansen-cli