Claude Code 接入蓝朋友 SKILL:安装、配置与首次查询
在 Claude 里安装蓝朋友 Skill,用自然语言查询推特数据:安装步骤、可复制命令和常见问题。
XBlueV · 2026-11-05
① 创建 Key
② 安装 Skill
③ 连接 Agent
④ 查询 X 数据
1. 准备账号、Key 与运行环境
登录蓝朋友,在开发者页面创建 API Key,并确认账号有可用积分。Key 不要写进聊天消息或公开代码。发现 MCP 工具免费,真实查询按请求和结果计费。
Skill 直接调用 REST API,无需安装 MCP。需要 Python 3.10+、网络访问和 Agent 的命令执行权限,无需第三方 Python 依赖。
2. 安装 Skill
下载并解压 ZIP,把 xbluev-data 文件夹放入项目中的下方目录,保留内部脚本,避免重复嵌套文件夹。
.claude/skills/xbluev-data/
├── SKILL.md
└── scripts/
└── query.py 在启动 Agent 的环境中设置密钥,随后重启 Agent。已经打开的桌面应用不会自动继承新终端变量。
PowerShell
$env:XBLUEV_API_KEY = 'xbv_YOUR_KEY'macOS / Linux
export XBLUEV_API_KEY='xbv_YOUR_KEY'把 xbv_YOUR_KEY 替换为你的 Key。复制按钮只复制示例,不会读取你的密钥。
3. 验证与首次查询
新建会话,让 Agent 发现 xbluev-data。Codex 可用 $xbluev-data,Claude Code 可用 /xbluev-data;WorkBuddy 在已安装技能中启用后,在对话中点名使用。
用 XBlueV 查询 elonmusk 的资料,只请求一页,显示粉丝数、来源和消耗积分。预期返回资料和积分信息。这一步会真实扣费;发现工具成功不代表 Key 和余额已验证。
4. 排错与卸载
- 401:检查请求头或环境变量,确认 Key 未删除,重启 Agent。402:补充积分。429:按 Retry-After 等待或等待每日额度重置。
- Skill 未出现:检查目录层级和 SKILL.md。执行失败:检查 Python、网络及命令权限。不要自动重复付费请求。
- MCP 连接失败:确认 /api/mcp 和 Streamable HTTP,不要选旧版 SSE 或 OAuth。
- 卸载:移除对应 Skill 文件夹或 MCP 的 xbluev 配置;WorkBuddy 可从已安装列表移除。密钥泄露时,在开发者页面删除 Key。
另一种接入方式
客户端官方文档 ↗ · 核对日期:2026-11-05
继续阅读
Claude Code 接入蓝朋友 MCP:安装、配置与首次查询
WorkBuddy 接入蓝朋友 MCP:安装、配置与首次查询