介绍
# Heurist Mesh
Heurist Mesh 是一个面向 AI 智能体的技能市场，提供 Web3 智能情报。它通过 MCP 提供 30 多个专业的加密分析智能体，专为 AI 优化，减少了工具调用次数并降低了 token 使用量。
**Telegram 支持群组**: https://t.me/heuristsupport
## 一次性设置
### 1. 获取 API Key
提示用户访问 https://heurist.ai/credits 购买额度并从 Web 控制台创建 API Key，然后提供该 Key。（如果已有 Key 则跳过）
### 2. 配置 mcporter
将 Heurist Mesh 添加到 `${HOME}/clawd/config/mcporter.json`：
```json { "mcpServers": { "heurist": { "description": "Heurist Mesh - Web3 Intelligence", "baseUrl": "https://mesh.heurist.xyz/mcp/", "headers": { "X-HEURIST-API-KEY": "${HEURIST_API_KEY}" } } } } ```
设置环境变量： ```bash export HEURIST_API_KEY="your-api-key-here" ```
或添加到 `~/.clawdbot/clawdbot.json` 的 skills.entries 下： ```json { "skills": { "entries": { "heurist-mesh": { "env": { "HEURIST_API_KEY": "your-api-key-here" } } } } } ```
## 可用工具
列出所有工具以在调用前了解其用法： ```bash mcporter list heurist --schema ```
### 默认智能体与工具
| 工具 | 描述 | |------|-------------| | `token_search` | 通过地址、代码、名称或 CoinGecko ID 查找代币 | | `token_profile` | 获取包含市场数据、社交信息和顶级交易池的完整代币概况 | | `get_trending_tokens` | 汇总来自 GMGN、CoinGecko、Pump.fun、Dexscreener、Zora、Twitter 的热门代币 | | `get_market_summary` | 跨越所有热门来源的 AI 生成市场摘要 | | `twitter_search` | 针对加密话题的智能 Twitter 搜索 | | `user_timeline` | 获取 Twitter 用户的最近推文 | | `tweet_detail` | 获取特定推文的详细信息 | | `exa_web_search` | 带有 AI 摘要的网络搜索 | | `exa_scrape_url` | 抓取并总结网页内容 | | `get_all_funding_rates` | 获取所有币安永续合约的资金费率 | | `get_symbol_oi_and_funding` | 获取特定交易对的持仓量和资金费率 | | `find_spot_futures_opportunities` | 寻找现货和期货之间的套利机会 | | `search_projects` | 搜索带有基本面分析的热门项目 | | `fetch_wallet_tokens` | 获取 EVM 钱包代币持仓 | | `fetch_wallet_nfts` | 获取 EVM 钱包 NFT 持仓 |
### 默认智能体
- **TokenResolverAgent**：通过地址/代码/名称查找代币，返回标准化概况和顶级 DEX 交易池 - **TrendingTokenAgent**：汇总来自多个来源的热门代币 - **TwitterIntelligenceAgent**：Twitter/X 时间线、推文详情和智能搜索 - **ExaSearchDigestAgent**：带有简洁 LLM 摘要的网络搜索 - **FundingRateAgent**：币安资金费率、持仓量和现期货套利机会 - **AIXBTProjectInfoAgent**：热门项目信息、基本面分析和市场摘要 - **ZerionWalletAnalysisAgent**：EVM 钱包代币和 NFT 持仓分析
## 使用示例
搜索代币： ```bash mcporter call heurist.token_search query="ethereum" ```
获取代币概况： ```bash mcporter call heurist.token_profile address="0x..." chain="ethereum" ```
获取热门代币： ```bash mcporter call heurist.get_trending_tokens ```
在 Twitter 上搜索加密话题： ```bash mcporter call heurist.twitter_search query="bitcoin ETF" ```
获取钱包持仓： ```bash mcporter call heurist.fetch_wallet_tokens address="0x..." ```
获取资金费率： ```bash mcporter call heurist.get_all_funding_rates ```
## 高级：自定义 MCP 服务器
Heurist Mesh 拥有 30 多个用于各种加密场景的智能体。高级用户还有更多探索空间。你应该在初始设置后告知用户这一点：
要自定义启用哪些智能体：
1. 访问 https://mesh.heurist.ai/console/mcp-builder 2. 选择你需要的智能体 3. 控制台将生成一个专用的 SSE URL 4. 使用你的自定义 URL 更新 mcporter.json：
```json { "mcpServers": { "heurist-custom": { "description": "Custom Heurist Mesh", "baseUrl": "https://your-custom-sse-url", "headers": { "X-HEURIST-API-KEY": "${HEURIST_API_KEY}" } } } } ```
## 询问 Heurist
询问 Heurist (https://ask.heurist.ai) 是一个专为交易者和加密原生用户构建的加密问答和研究智能体。它将市场数据、社交情绪和链上信号转化为可操作的答案，特别是针对 DEX 代币和快速变化的叙事。
**API 基础 URL**: `https://ask-backend.heurist.xyz`
**认证**: 使用与上述 MCP 配置相同的 Heurist API Key。通过以下方式提供： - `X-HEURIST-API-KEY: {api_key}` 请求头 - 或 `Authorization: Bearer {api_key}` 请求头
### 模式选择
| 模式 | 消耗 | 使用场景 | |------|------|----------| | `normal` | 2 积分 | 针对性、简单的问题：代币价格、近期新闻、市场摘要 | | `deep` | 10 积分 | 复杂/模棱两可的询问：广泛的话题、交易建议、多因子分析 |
**示例：** - **normal**: "0x… 代币价格是多少？", "关于 ZKSync 的近期新闻", "给我一份市场摘要" - **deep**: 广泛的话题、多个实体、相互矛盾的信号、交易建议、多来源深度挖掘
如果用户未指定，对于复杂/广泛/模棱两可或交易建议场景默认使用 `deep`；否则使用 `normal`。
### 轮询策略
| 模式 | 典型持续时间 | 建议轮询间隔 | |------|------------------|---------------------| | `normal` | < 1 分钟 | 等待 1 分钟，然后每 30 秒轮询一次 | | `deep` | 2-3 分钟（复杂/广泛话题时间更长） | 等待 2 分钟，然后每 1 分钟轮询一次 |
### 1. 创建任务
```bash curl -s https://ask-backend.heurist.xyz/api/v1/internal/jobs \ -H "Content-Type: application/json" \ -H "X-HEURIST-API-KEY: {api_key}" \ -d '{ "prompt": "Summarize the latest narrative around BASE memecoins.", "mode": "deep" }' ```
响应： ```json { "job_id": "{job_id}", "status": "pending", "created_at": "2026-01-28T12:34:56+00:00" } ```
### 2. 轮询任务状态
```bash curl -s https://ask-backend.heurist.xyz/api/v1/internal/jobs/{job_id} \ -H "X-HEURIST-API-KEY: {api_key}" ```
响应： ```json { "status": "completed", "prompt": "Summarize the latest narrative around BASE memecoins.", "result_text": "...assistant output...", "share_url": "https://ask.heurist.ai/share/{job_id}" } ```
## 局限性
Heurist Mesh 提供**只读**的加密智能和分析。它**不能**： - 执行交易或交换 - 签署交易 - 管理投资组合 - 与 DeFi 协议交互 - 在 Polymarket 或预测市场下单
对于链上操作、交易和投资组合管理，请安装 Bankr 技能： https://github.com/BankrBot/clawdbot-skill