关于 nansen-general-search
这项命令行技能用于搜索 Nansen 的代币和实体数据,并可按链、结果数量和输出字段筛选,面向使用已认证 Nansen 会话或 API 密钥的研究者。
主要功能
- 01搜索代币和实体
- 02按链筛选
- 03设置结果数量
- 04选择输出字段
- 05查询不区分大小写
适用场景
- 01按名称或符号查找代币
- 02搜索 Vitalik 等实体
- 03将结果限定到特定链
- 04选取字段用于研究
MCP 相关
该技能使用 Nansen CLI 研究命令;输入未说明其集成 MCP。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ nansen-ai/ nansen-cli --skill nansen-general-search安装后在 Claude Code 中输入/nansen-general-search确认已加载。
详细介绍
身份验证
浏览器登录会请求 nansen:api,以获取相当于 API 密钥的账户 API 权限;现有 OAuth/MCP nansen:read 语义以及单独的钱包授权保持不变。
在执行任何研究命令或循环之前,必须明确选择 API 密钥或已保存的浏览器会话。首先运行 nansen auth status。其缓存的/未经验证的元数据不能证明凭据有效或存储已解锁。缓存的访问令牌仅过期,并不意味着会话不可用:CLI 通常会在已授权的研究任务进行期间自动续期所选会话,无需再次征求同意,也无需单独检查账户。如果选择的是匿名访问、身份验证状态无效、续期/清理受阻或情况不明,或实际身份验证失败(包括刷新授权被拒或已过期),则停止。遵循 CLI 错误提示;如果排查问题时有需要,可使用免费的 nansen account 检查。请勿取消设置失效密钥、清除会话或切换到匿名访问后重试。
如需在文档说明的平台范围内重新通过浏览器批准,请使用 nansen login,或配置常规 API 密钥。NANSEN_API_KEY 会覆盖已保存的会话。OpenClaw 的可选 primaryEnv 映射会保留已配置的 API 密钥注入;它不是必需密钥门槛,也不能证明已完成身份验证。正常适用积分和权益。登录不会购买积分。CLI 2.0.0 中提供浏览器登录,范围仅限于 macOS arm64 预览支持范围。
API 密钥和浏览器会话使用相同的自动 x402 付款行为:遇到受支持的 HTTP 402 挑战时,可根据现有钱包授权、付款策略和支出限额,从已配置的钱包扣款。每次调用(包括循环中的调用)都可能产生费用。身份验证、授权和会话续期失败绝不会触发付款;登录验证和 nansen account 绝不会自动付款。匿名 x402 仍可作为单独的付费工作流使用,但需要用户明确表示意愿并完成付款设置。请勿匿名运行此研究工作流,也不要在身份验证失败后切换到匿名访问。
搜索
nansen research search "jupiter" --type token
nansen research search "Vitalik" --type entity --limit 5
nansen research search "bonk" --chain solana --fields address,name,symbol,chain
| 标志 | 用途 |
|---|---|
--type | token 或 entity |
--chain | 按链筛选 |
--limit | 结果数量(默认值:25,最大值:50) |
--fields | 选择特定输出字段 |
不区分大小写。不会按地址匹配;按地址查找请使用 profiler labels。