---
title: "在 AI 助手中使用 BlockReq"
description: "面向编码智能体的 llms.txt、Markdown 页面、OpenRPC、networks.json 与 blockreq-rpc Agent Skill"
url: "https://blockreq.com/docs/zh-cn/build/ai-assistants/"
---

# 在 AI 助手中使用 BlockReq

BlockReq 以 AI 助手和编码智能体可以直接读取的形式发布文档。下面所有内容都由与本站页面相同的目录和模板生成，与页面保持同步。

## 机器可读文档

| 资源                                                     | 内容                                                                                                                                            |
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| [llms.txt](https://blockreq.com/docs/llms.txt)           | 按主题分组的全部文档页索引，遵循 llmstxt.org 格式                                                                                               |
| [llms-full.txt](https://blockreq.com/docs/llms-full.txt) | 合并为一个 Markdown 文件的核心文档，附网络能力表，每个 JSON-RPC 方法出现一次                                                                    |
| Markdown 页面                                            | 每个页面都有 Markdown 版本：在 URL 后加 `index.md`，例如 `https://blockreq.com/docs/zh-cn/build/api-reference/ethereum/eth_getBalance/index.md` |
| [networks.json](https://blockreq.com/docs/networks.json) | 每个已发布网络的主机名、公开 URL、私有 URL 形式、WSS，以及 Archive 与 proof/debug/trace 标记                                                    |
| [OpenRPC](https://blockreq.com/docs/openrpc/index.json)  | 每个 EVM 网络一份 OpenRPC 文档，只列出为该网络提供文档的方法                                                                                    |

通用智能体可以直接读取 `https://blockreq.com/docs/llms.txt`，再按需跟进其中的链接。

## blockreq-rpc Agent Skill

`blockreq-rpc` Skill 教编码智能体如何调用 BlockReq：端点 URL、如何选择网络主机名、哪些方法需要 Archive 数据或只在 proof/debug/trace 网络上提供、通过 WSS 使用 `eth_subscribe`、Request Counting 与套餐限制、简短的 viem、ethers、curl 与 web3.py 示例，以及常见问题。

- 在线查看：[SKILL.md](https://blockreq.com/docs/agent-skills/blockreq-rpc/SKILL.md)，以及[网络](https://blockreq.com/docs/agent-skills/blockreq-rpc/reference/networks.md)与[方法](https://blockreq.com/docs/agent-skills/blockreq-rpc/reference/methods.md)参考。
- 下载：[blockreq-rpc.zip](https://blockreq.com/docs/agent-skills/blockreq-rpc.zip)。

### Claude Code

为当前用户安装，所有项目都能使用：

```bash
mkdir -p ~/.claude/skills && cd ~/.claude/skills
curl -fsSLO https://blockreq.com/docs/agent-skills/blockreq-rpc.zip
unzip -o blockreq-rpc.zip && rm blockreq-rpc.zip
```

也可以只为一个项目安装：解压到该项目的 `.claude/skills/` 目录，随代码一起提交。两种方式下 Skill 都位于 `blockreq-rpc/` 目录，任务涉及 BlockReq RPC 时 Claude Code 会加载它。

### Claude.ai

下载 `blockreq-rpc.zip`，在 Claude.ai 中作为自定义 Skill 上传。自定义 Skill 需要 Pro、Max、Team 或 Enterprise 套餐并开启代码执行；上传入口见 Anthropic 的 [Using Skills in Claude](https://support.claude.com/en/articles/12512180-using-skills-in-claude)。

### 其他智能体

不读取 Agent Skill 的智能体可以使用 `https://blockreq.com/docs/llms.txt`，或把 `SKILL.md` 及其参考文件作为指令加载。

## 后续计划

BlockReq 的 MCP 服务器正在规划中，目前尚不可用；可用时本页会更新说明。