# 在 Cursor 里用 DataXAPI

让 Cursor 读到 21 个平台的公开数据。贴一段提示词，它自己接好：5 个工具，207 个接口，一次 $0.0003 起，失败的调用不收费。

把这段话贴进 Cursor：

> 读 https://dataxapi.com/agents.md，在这个 agent 里帮我接好 DataXAPI。我的 API Key 是 dx_…，之后所有 DataXAPI 的调用都用它。

Cursor 会去读那一页，加上 MCP 服务，并列出工具。

## 或者手动配

在终端里三步。上面那段提示词让 Cursor 做的就是这些。

1. 把 Key 放进环境变量：Cursor 从这里读。想长期保留，就把这一行加进 shell 配置。

```bash
export DATAXAPI_API_KEY="dx_…"
```

2. 加上这个服务：一条命令，或者把同样的内容写进 `~/.cursor/mcp.json`。

```bash
dataxapi setup --client cursor
```

```json
{
  "mcpServers": {
    "dataxapi": {
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:DATAXAPI_API_KEY}"
      }
    }
  }
}
```

3. 重启 Cursor：然后让它列出 DataXAPI 的工具，应该是下面这五个。

## 确认接好了

让它把工具列出来。应该得到下面这样的回答，这一步不花钱。

> 列出 DataXAPI 的工具。

DataXAPI 已连接，有 5 个工具：`find` 按需求找接口，`describe` 看参数和价格，`call` 调用（只有它扣费），`read_more` 在 24 小时内重读结果，`account` 看余额。目录里有 21 个平台的 207 个接口。

## 第一次对话

一个问题、它调了哪几次、每次多少钱。

> @nasa 最近在 TikTok 上发了什么？

|  |  |  |
| --- | --- | --- |
| `find({ query: "tiktok account recent videos" })` | 找到 tiktok.users.videos.list · TikTok 用户作品 · 一次 $0.0020 | 免费 |
| `call({ capability: "tiktok.users.videos.list", username: "nasa", max_price: "0.01" })` | 最多 10 条视频 · 精简档 | $0.0020 |

2 次工具调用 · 1 次扣费 · $0.0020

## 在 Cursor 里的几个提示

- **给它单独一把 Key.** 在控制台建一把叫“Cursor”的 Key，设好每天的预算。预算用完，调用就停，账户里别的不受影响。
- **让不花钱的工具免确认.** 如果 Cursor 运行工具前会先问你，放行 `find`、`describe`、`read_more` 和 `account`。想逐笔确认扣费，就让 `call` 保持“询问”。
- **返回放得进上下文.** DataXAPI 的返回在约 20 KB 处按条目截断，并写明怎么往下读；剩下的用 `read_more` 取，不扣费。
- **给每次调用设最高价.** 让它每次调用都带 `max_price`。可能超过这个价的调用，在扣费前就被拒绝。

## 遇到问题时

| 你看到的 | 原因 | 怎么办 |
| --- | --- | --- |
| Cursor 里看不到 DataXAPI 的工具 | 加配置之前 Cursor 就已经开着了，或者地址和上面的不一样。 | 核对一下配置，然后把 Cursor 退出再打开。 |
| `find` 能用，`call` 报 `unauthorized` | Key 没有从 Cursor 送到服务端。两个不要 Key 的工具照常能用。 | 看看 Key 是不是放在配置读取的那个地方、是不是以 `dx_` 开头，然后重启。 |
| `call` 报 `insufficient_balance` 或 `key_budget_exceeded` | 余额或这把 Key 的预算不够这一次的价格。没有扣费。 | 让它跑一次 `account`，然后充值或者调高这把 Key 的预算。 |

## 全部客户端

- [在 Claude Code 里用 DataXAPI](https://dataxapi.com/zh/integrations/claude-code/)
- [在 Codex 里用 DataXAPI](https://dataxapi.com/zh/integrations/codex/)
- [在 n8n 里用 DataXAPI](https://dataxapi.com/zh/integrations/n8n/)
- [在 Cherry Studio 里用 DataXAPI](https://dataxapi.com/zh/integrations/cherry-studio/)
- [MCP 服务](https://dataxapi.com/zh/mcp/)
- [agent 自己接入时读的那一页](https://dataxapi.com/zh/agents/)

---

按目录修订号 c48ce454ae6c4c65、价目版本 2生成。 [网页版](https://dataxapi.com/zh/integrations/cursor/)