内容
<p align="center">
<img src="https://vaaya.ai/icon.png" width="96" height="96" alt="Vaaya" />
</p>
# Vaaya MCP — 付费增强功能，适用于任何代理
[Vaaya](https://vaaya.ai) 是 **代理支付系统**：一个 MCP 服务器，允许任何代理调用付费 API **按调用付费，无需 API 密钥**。代理无需配置十几个供应商密钥，只需向 Vaaya 的对话式 `consult` 工具请求无法执行的操作，获取确切的调用指令，并使用 `use` 执行 — 仅在成功时计费（在 Base 上为 x402 USDC，在 Stripe MPP 或 Tempo 上为 Stripe MPP；支付 *即* 授权）。失败的调用永远不会被收费。
## 代理可以通过 Vaaya 执行的操作
| 功能 | 您获得的内容 |
| --- | --- |
| 🎨 **媒体生成** | 使用顶级模型生成图像和视频 — Nano Banana Pro 2、GPT Image 2、Seedream v4.5、Kling v3、Seedance 2.0 — 以及 TTS 语音和音乐 |
| 🎬 **产品演示视频** | 记录您的实时产品的原始、静音屏幕截图；Vaaya 自动生成旁白 + 缩放/剪辑计划，并渲染成品的旁白演示 |
| 🖼️ **网站图像** | 获取网站的品牌并直接在您的存储库中生成品牌图像集 |
| 🔎 **网络搜索** | Exa 和 Parallel：查询搜索、URL 内容、异步深度研究任务 |
| 🕷️ **网络爬虫** | Firecrawl 爬取/爬行/映射/搜索/提取，持久化到文件中 |
| 📚 **深度研究** | 多跳、来源验证、引用研究报告 |
| 📊 **市场和竞争研究** | 公司报告（人员、招聘、广告、评论、SEO/LLM 可见性）、产品和功能目录（附评论情绪）、UX 研究（附交互式产品地图）、"适用于我的数据"的最佳 X 竞争对手评测、持久的竞争知识存储库 |
| 🎯 **GTM 和销售** | 查找与 ICP 匹配的潜在客户（附验证的联系信息）、丰富联系信息、跟踪购买信号（资金/招聘/发布/新闻）、24 小时 LinkedIn 发现、基于分段的 outbound 电子邮件 — 每个草稿都需人工审批 |
| ⏰ **监控工作器** | 按时间表（30 分钟至每周）监控竞争对手的定价、交易、评论、职位发布、新闻 — 仅显示新的/更改的发现 |
| 🖥️ **计算沙盒** | 每秒计费的代码执行（Modal）用于基准测试、不可信代码、GPU 推理、数据作业 |
| 🌐 **浏览器自动化** | Browserbase 会话，用于点击、输入、登录、填写表单 |
| 📧 **电子邮件** | 代理邮件 inbox — 由代理所有 — 发送和接收回复 |
| 🧠 **内存** | 通过 mem0、Zep 或 Letta 实现的持久跨会话内存 |
## 安装
### 一条命令（推荐）
```bash
npx vaaya-cli install
```
为您的机器上检测到的每个代理设置 Vaaya MCP 服务器 — Claude Code、Claude Desktop、Cursor、Codex — 以及代理技能。幂等：随时重新运行以更新。然后重启您的代理；第一次 Vaaya 调用将打开一个简短的浏览器审批（注册直接在那里进行）。
### 远程（Streamable HTTP + OAuth）
<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=vaaya&config=eyJ1cmwiOiJodHRwczovL3ZhYXlhLmFpL21jcCJ9"><img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="将 Vaaya 添加到 Cursor" height="32" /></a>
```json
{ "mcpServers": { "vaaya": { "url": "https://vaaya.ai/mcp" } } }
```
克劳德代码：
```bash
claude mcp add --transport http vaaya https://vaaya.ai/mcp
```
在首次使用时，您的客户端会在浏览器中运行 OAuth 流；批准后，您已连接。随时在 [vaaya.ai/connected-apps](https://vaaya.ai/connected-apps) 撤销。
### npm stdio shim（适用于仅支持stdio的客户端：opencode，…）
```json
{ "mcpServers": { "vaaya": { "command": "npx", "args": ["-y", "@vaaya/mcp"] } } }
```
shim（[`@vaaya/mcp`](https://www.npmjs.com/package/@vaaya/mcp)）在首次调用时打开 OAuth 流，在本地存储刷新令牌（`0o600`），并代理来自后端的实时工具列表 — 无需 shim 升级即可出现新的服务器端工具。它还附带一个代理技能，以便您的客户端自动将每个功能差距路由到 `consult`。
### 代理技能（适用于 70 多个代理）
```bash
npx skills add MaruPelkar/vaaya-mcp
```
为克劳德代码、Codex、Cursor、Gemini CLI、Copilot 和任何其他支持开放 [代理技能](https://agentskills.io) 标准的客户端安装 [`vaaya` 技能](skills/vaaya/SKILL.md)。该技能在 Vaaya MCP 服务器缺失时引导启动，并在保持安装更新。
### 作为插件
- **克劳德代码**：`/plugin marketplace add MaruPelkar/vaaya-mcp` 然后 `/plugin install vaaya@vaaya`
- **Codex**：`codex plugin marketplace add MaruPelkar/vaaya-mcp` 然后在插件面板中安装 `vaaya`
- **Gemini CLI**：`gemini extensions install https://github.com/MaruPelkar/vaaya-mcp`
## 工作原理
1. **`consult(intent)`** — 用纯英文描述任何目标（“生成一个英雄视频”，“查找 50 个具有验证邮箱的 RevOps 负责人”，“监控竞争对手的定价页面”）。它会进行对话，澄清并返回要运行的确切调用。
2. **`use(service, action, params, max_cost_cents)`** — 执行调用。成功时计费；`max_cost_cents` 是一个严格的支出上限。长时间作业返回 `{ async: true, job_id }` — 使用 **`result(job_id)`** 进行轮询。
3. **`session`** / **`close`** — 每秒计费的代码沙盒会话。
以及完整的 GTM 套件（`gtm_leads_find`、`gtm_lead_enrich`、`gtm_signal_create`、`gtm_segments`、`gtm_message`、`gtm_replies`，…）和定时监控工作器（`worker_create`、`worker_findings`，…）— 共 34 个工具。
## 示例提示
- “为我们的着陆页生成一个英雄视频，比例为 16:9。”
- “记录我的产品并将其变成一个有旁白的演示视频。”
- “在具有验证电子邮件的 Series-B SaaS 公司中查找 50 个 RevOps 负责人。”
- “监控竞争对手的定价页面，并在其发生变化时通知我。”
- “对代理支付市场进行深入研究，提供引用的来源。”
- “将这 200 个产品页面爬取到结构化的 JSON 中。”
- “在 GPU 沙盒中运行此基准测试。”
## CLI
[`vaaya-cli`](https://www.npmjs.com/package/vaaya-cli) CLI 从终端管理所有内容：
```bash
npx vaaya-cli install # 为每个检测到的代理设置 MCP 服务器
npx vaaya-cli status # 连接状态 + 实时工具数量
npx vaaya-cli consult "..." # 询问 Vaaya 如何执行某事（返回计划）
npx vaaya-cli reauthorize # 重新运行浏览器身份验证流程
npx vaaya-cli logout # 断开连接并删除本地凭证
```
## 安全性和计费
- 您的代理永远不会看到供应商 API 密钥或上游 URL — Vaaya 在服务器端代理每个调用。
- OAuth 2.1（PKCE，动态客户端注册）；用于发现的匿名 `tools/list`；可撤销的授权。
- 在 x402（Base 上的 USDC）、Stripe MPP/SPT 或 Tempo 上按调用付费。失败的调用永远不会被收费。每个调用都带有 `max_cost_cents` 保护。
## 链接
- 网站和文档：https://vaaya.ai
- npm：https://www.npmjs.com/package/@vaaya/mcp · https://www.npmjs.com/package/vaaya-cli
- 支持：support@vaaya.ai
