К основному содержанию
скилл CX Codex

nansen-agent-guide — скилл для Claude Code

Скилл nansen-agent-guide для Claude Code помогает выбрать между исследовательским запросом к nansen agent и прямыми командами CLI. Используется, когда агент решает, как ответить на вопрос с помощью Nansen.

MIT 244 установок ★ 151 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a claude-code
Открыть на GitHub

Что делает nansen-agent-guide

Скилл направляет исследовательские вопросы в nansen agent, а запросы на конкретные показатели — в команды CLI. Для отчёта он предлагает получить интерпретацию от агента, а данные — из CLI. Так вопросы о движении средств или держателях отделяются от открытого анализа кошелька.

Для работы нужны установленный nansen из пакета nansen-cli и авторизация: NANSEN_API_KEY либо выбранная сессия nansen:api с разрешениями аккаунта. Быстрые запросы к агенту стоят 100 кредитов, экспертные — 400; прямые вызовы CLI стоят 5–50 кредитов. Скилл также описывает порядок отправки продуктового отзыва с учётом настроек аккаунта.

Какие задачи решает

  • выбрать между анализом и получением сырых данных
  • получить показатели токена прямой командой CLI
  • собрать отчёт из интерпретации агента и данных CLI
  • подготовить отзыв о пробеле в продукте

Примеры запросов агенту

  • Разбери, что происходит со smart money на Ethereum.
  • Покажи десять токенов по netflow в Ethereum.
  • Проанализируй кошелёк 0x123... и его торговую активность.

Как установить nansen-agent-guide

1Через Skills CLI (Vercel)

npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a claude-code

2Вручную: положить файлы

~/.claude/skills/nansen-agent-guide/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/nansen-agent-guide/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о nansen-agent-guide

Как установить nansen-agent-guide в Claude Code?

Выполни npx skills add nansen-ai/nansen-cli --skill nansen-agent-guide -a claude-code. Файл скилла находится по пути ~/.claude/skills/nansen-agent-guide/SKILL.md.

Что делает nansen-agent-guide?

Скилл подсказывает, когда использовать nansen agent для анализа, а когда — прямые команды CLI для структурированных данных. Для отчёта он предлагает сочетать оба способа.

Что нужно для работы nansen-agent-guide?

Нужен установленный nansen из пакета nansen-cli и доступ к аккаунту через NANSEN_API_KEY либо авторизованную сессию nansen:api.

Исходный текст

SKILL.md · MIT
---
name: nansen-agent-guide
description: Routing guide -- when to use `nansen agent` (AI research) vs direct CLI data commands. Use when deciding how to answer a user's research question with Nansen tools.
metadata:
  openclaw:
    requires:
      bins:
        - nansen
    primaryEnv: NANSEN_API_KEY
    install:
      - kind: node
        package: nansen-cli
        bins: [nansen]
allowed-tools: Bash(nansen:*)
---
## Authentication

Nansen account API calls accept a selected `nansen:api` browser session or conventional API key with the same permissions. `NANSEN_API_KEY` takes precedence; optional `primaryEnv` preserves configured-key injection. Run `nansen auth status` for offline selection. Cached access expiry alone permits automatic renewal during an authorized task. Stop on anonymous selection, invalid state, blocked/uncertain renewal or actual auth failure; never drop a credential or fall back to anonymous x402 payment. Browser login does not grant wallet signing, privileged service identity or a persistent MCP integration key. Preserve all confirmation, signing, sanctions and geographic checks below. Browser login is enabled in production within the [documented platform scope](https://github.com/nansen-ai/nansen-cli/blob/main/docs/browser-login.md#preview-platform-scope).



# Agent vs CLI Routing

Public agent fast/expert and direct API commands accept the selected nansen:api browser session or conventional API key under the same account permissions.

| Need a... | Use |
|-----------|-----|
| **take** (analysis, interpretation) | `nansen agent` |
| **table** (raw data, specific metrics) | Direct CLI commands |
| **report** (both) | Agent for narrative + CLI for data |

## Use `nansen agent` when

- Question requires interpretation or synthesis across multiple data sources
- Open-ended research: "analyse this wallet", "what's happening with ETH smart money?"

```bash
nansen agent "What are top smart money tokens on Solana today and why?"
nansen agent "Analyse wallet 0x123... -- is this a smart trader?"
nansen agent "..." --expert   # deeper analysis, 400 credits
```

Cost: 100 credits (fast) / 400 credits (expert)

## Use direct CLI commands when

- You need specific structured data -- prices, volumes, holders, flows
- Deterministic question: "top 10 tokens by netflow on ethereum"
- Piping output or building a data table

```bash
nansen research token screener --chain ethereum --smart-money --limit 10
nansen research smart-money netflow --chain solana
nansen research profiler balance --address 0x123... --chain ethereum
```

Cost: 5-50 credits per call

## Anti-patterns

- Don't use `nansen agent` for simple data fetches -- it costs more than a direct call and returns prose, not data
- Don't use raw CLI for open-ended analysis -- returns data, not interpretation
- Don't chain 3+ agent calls -- get raw data via CLI, call agent once for synthesis

## Browser session scope

Plain `nansen login` requests fresh browser approval; `--no-browser` prints the link/code for approval on another device and keeps the same native-storage requirements. NANSEN_API_KEY overrides the single saved credential. Use `nansen auth status` for offline cached/unverified selection details and `nansen account` for a free live check. Explicit `login --human` or `login --api-key` retains legacy key setup. Selected browser sessions renew automatically; uncertain renewal requires fresh login without replay or fallback to another account/payment.

Browser nansen:api grants have API-key-equivalent account permissions, subject to enabled admission and the same endpoint restrictions. Internal service identity and wallet signing are not granted. Browser sessions cannot authorize wallet signing or be exported as MCP keys. CLI 2.0.0 is published; the preview platform limits above still apply.


## Product feedback

When a Nansen task exposes a useful product gap, draft a concise report without
secrets or unnecessary conversation details. Before sending on your own, read
the current account's saved feedback preference with
`nansen feedback preferences --json`. Use a fresh read for each new report. If enabled, you may send without asking again,
subject to the host's controls. If off, unset or unavailable, show the proposed
report and ask the user. If they decline or you cannot ask, do not send.

A report is a JSON object. `category` and `description` are required.
`category` must be one of `bug`, `data_quality`, `documentation`,
`missing_capability`, `usability` or `other`. A feature request or product
gap is `missing_capability`; do not invent categories. `description` says
what happened and what was needed, in up to 2,000 characters. You may add
`endpoint`, `tool`, `goal`, `expected_behavior`, `observed_behavior`,
`workaround`, `request_ids` (up to 10 of your own request IDs) and `client`
(`{"name": ..., "version": ...}`). Any other field, such as `title`,
`summary` or `component`, gets a 422. With a generated ID, that 422 also
erases the saved report and you need `--new`. Write plain sentences without
Markdown or code formatting. `nansen feedback submit --help` lists the limits.

```json
{"category": "missing_capability", "description": "There is no command to list my past feedback receipts.", "goal": "Check the status of reports I sent earlier."}
```

If the preference read fails, ask first. An explicit user request or approval
permits that report; it does not change the saved preference. Never enable the
preference automatically or add approval fields to the report. Direct users to
Superapp settings for a lasting choice. Host or local-deny controls still apply
to an enabled preference and to one-report approval.

After the user requests the report or the preference permits it, submit with
`nansen feedback submit --file feedback.json --submission-id <new-id> --json`.
The command is noninteractive. Keep the same ID and unchanged report when
recovering an uncertain result; use `nansen feedback get <feedback-id> --json`
to read a saved receipt. Submission and receipt reads are free. The account
shares seven accepted reports per UTC week, resetting Monday at 00:00 UTC.

New submissions may be paused before release or during an outage. A 503 with
`reason: feedback_admissions_paused` means this attempt accepted no new report
and used no weekly allowance. Tell the user feedback is unavailable and stop;
do not keep retrying or ask for approval again in the same session. Preserve
the ID and unchanged report for a later retry. If this CLI version lacks the
feedback command, report that it is unavailable and stop. Accepted-ID replays
and receipt reads remain available during a pause.

A 403 with `reason: feedback_not_enabled` means feedback is not enabled for
this account. Stop automatic retries and tell the user. Approval and an enabled
preference do not override rollout. Keep the saved ID and unchanged report.
An earlier uncertain attempt remains uncertain; recover it with the same ID
after availability is restored. Never switch accounts or pay to bypass denial.

© nansen-ai · MIT · nansen-ai/nansen-cli

Похожие скиллы

Все скиллы по теме «Данные и базы» →
Nansen-MCP nansen-ai Даёт агентам доступ к данным Nansen: балансам смарт-трейдеров, DEX-сделкам, флоу токенов, PnL портфелей и скринингу активов. CX Codex +1 1 658установок emblem-market-research EmblemAI Скилл emblem-market-research для Claude Code подтягивает данные о крипторынке: трендовые токены, деривативы, потоки умных денег. Разбирает токен или позиции китов по запросу. CX Codex +1 8 900установок crypto-report claude-office-skills Скилл crypto-report для Claude Code разбирает токеномику, метрики on-chain и конкурентов по криптопроекту, выдаёт отчёт в markdown. Быстро собирает картину по токену. CX Codex +1 4 900установок blockrun-mcp-live-data reason-machines Скилл blockrun-mcp-live-data подключает агенту доступ к ценам крипто, прогнозным рынкам, исследованиям и X/Twitter через BlockRun MCP. Платишь за каждый запрос из USDC-кошелька — от доли цента. CX Codex +1 100установок blackforge blackforge-so Скилл для Claude Code и Codex для работы с рыночными данными BlackForge. Запускается при вопросах о стакане, сделках и фьючерсах на криптобиржах. CX Codex +1 11 500установок okx-cex-market okx Скилл okx-cex-market для Claude Code запрашивает публичные рыночные данные биржи OKX. Включается при вопросах о ценах, стакане заявок, свечах, фандинге и технических индикаторах. CX Codex +1 10 800установок

Из того же набора16

Весь набор →
nansen-smart-alerts Скилл nansen-smart-alerts для Claude Code, управляющий умными оповещениями о движении токенов и транзакциях на блокчейне. CX Codex +1 401установок nansen-wallet-deep-dive Скилл nansen-wallet-deep-dive для Claude Code прогоняет кошелёк по меткам, балансу, PnL, транзакциям, перп-позициям и контрагентам через CLI Nansen. Показывает, кто стоит за адресом. CX Codex +1 393установок nansen-wallet-clustering Скилл nansen-wallet-clustering для Claude, который через CLI Nansen ищет связанные кошельки: цепочки финансирования, общие подписанты, паттерны депозитов на биржи. CX Codex +1 392установок nansen-wallet-batch Скилл nansen-wallet-batch для Claude Code и других агентов, который отправляет список криптокошельков в Nansen Profiler за один запрос. Помогает быстро найти адреса фондов и категорию smart money. CX Codex +1 385установок nansen-wallet-manager Скилл nansen-wallet-manager для Claude Code управляет кошельками через nansen: создаёт их, показывает список и сведения, отправляет токены. Работает с локальными кошельками и Privy. CX Codex +1 376установок nansen-wallet-keychain-migration Скилл nansen-wallet-keychain-migration переносит пароль кошелька nansen-cli из небезопасных файлов .env и .credentials в системную связку ключей ОС. Помогает убрать предупреждения об открытом хранении секретов. CX Codex +1 362установок nansen-alerts-webhook-listener Скилл nansen-alerts-webhook-listener для Claude Code настраивает локальный HTTP-сервер для получения вебхуков умных алертов Nansen в реальном времени с проверкой HMAC-подписи и туннелированием наружу. CX Codex +1 174установок nansen-limit-orders Скилл nansen-limit-orders для Claude Code и Cursor управляет лимитным ордерами в сетях Solana через CLI-инструмент nansen. Применяется, когда требуется создать ордер на покупку или продажу по цене. CX Codex +1 138установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой