内容
# Grok 代理商店
**仅限代理的垂直技能市场**，由 **xAI Grok API** 独家支持。
买方代理发现技能，注册积分，调用 Grok 支持的工具，并接收签名收据。人类设置操作员密钥；代理执行商务。
## 🤖 代理：从这里开始
**主索引：** https://grok-agent-store.manhatton31.workers.dev/discovery.json
```text
MCP: https://grok-agent-store.manhatton31.workers.dev/mcp
技能： https://grok-agent-store.manhatton31.workers.dev/skills.json
卡片： https://grok-agent-store.manhatton31.workers.dev/.well-known/agent.json
llms: https://grok-agent-store.manhatton31.workers.dev/llms.txt
服务器： https://grok-agent-store.manhatton31.workers.dev/server.json
```
首次调用：
```bash
curl -s https://grok-agent-store.manhatton31.workers.dev/v1/invoke \
-H "content-type: application/json" \
-d '{"skill_id":"register_agent","input":{"name":"my-buyer"}}'
```
## 代理可获得的内容
| 端点 | 目的 |
|---|---|
| `GET /discovery.json` | **主发现索引** |
| `GET /skills.json` | 技能图（价格，模式） |
| `GET /.well-known/agent.json` | A2A 样式代理卡 |
| `GET /server.json` | 官方 MCP 注册表格式 |
| `GET /mcp.json` | 客户端配置片段 |
| `GET /openapi.json` | OpenAPI 3.1 |
| `GET /llms.txt` / `/ai.txt` / `/AGENTS.md` | 机器指令 |
| `GET /robots.txt` / `/sitemap.xml` | 爬虫表面 |
| `POST /v1/invoke` | REST 技能调用 |
| `POST /mcp` | MCP 流式 HTTP |
## 技能（MVP）
| 技能 | 积分 | 认证 |
|---|---:|---|
| `list_skills` / `get_skill` / `quote` | 0 | 否 |
| `register_agent` | 0 (+ 奖励) | 否 |
| `balance` | 0 | 是 |
| `skill_match` | 5 | 是 |
| `agent_brief` | 10 | 是 |
| `structured_extract` | 15 | 是 |
| `code_review` | 25 | 是 |
## 快速入门（本地）
```bash
cd grok-agent-store
npm install
# 将您的密钥放入 .dev.vars（gitignored 模式如下）
npx wrangler dev
```
`.dev.vars`:
```
XAI_API_KEY=xai-...
PUBLIC_BASE_URL=http://127.0.0.1:8787
GROK_MODEL=grok-4
SIGNUP_BONUS_CREDITS=100
```
### 代理流程
```bash
# 1) 注册
curl -s http://127.0.0.1:8787/v1/invoke \
-H "content-type: application/json" \
-d '{"skill_id":"register_agent","input":{"name":"demo-buyer"}}'
# 2) 使用付费技能（粘贴 api_key）
curl -s http://127.0.0.1:8787/v1/invoke \
-H "content-type: application/json" \
-H "Authorization: Bearer gas_..." \
-d '{"skill_id":"agent_brief","input":{"goal":"Launch an agent marketplace"}}'
```
### MCP 客户端
将 Streamable HTTP MCP 指向 `https://<your-host>/mcp` 并发送：
`Authorization: Bearer gas_...`
## 现场部署（当前）
**公共基础：** https://grok-agent-store.manhatton31.workers.dev
| 界面 | URL |
|---|---|
| 技能图 | https://grok-agent-store.manhatton31.workers.dev/skills.json |
| 代理卡 | https://grok-agent-store.manhatton31.workers.dev/.well-known/agent.json |
| OpenAPI | https://grok-agent-store.manhatton31.workers.dev/openapi.json |
| llms.txt | https://grok-agent-store.manhatton31.workers.dev/llms.txt |
| REST 调用 | `POST` https://grok-agent-store.manhatton31.workers.dev/v1/invoke |
| MCP | https://grok-agent-store.manhatton31.workers.dev/mcp |
此次部署使用 `wrangler deploy --temporary`（预览帐户）。**请在 60 分钟内认领帐户**，否则部署可能会过期：
https://dash.cloudflare.com/claim-preview?claimToken=6ByjulVj7W-mC6i6KWid0OqyEomj8Wt5lZoUDSbWI1s
### 操作员必填步骤：Grok 机密
付费技能需要您的 xAI 密钥：
```bash
npx wrangler secret put XAI_API_KEY --temporary
# 从 https://console.x.ai 粘贴密钥
```
在设置之前，`/health` 显示 `"grok_configured": false`，Grok 工具返回错误。
## 部署（Cloudflare Workers，永久）
```bash
npx wrangler login
npx wrangler kv namespace create STORE
# 将 ID 粘贴到 wrangler.jsonc 中
npx wrangler secret put XAI_API_KEY
# 在 wrangler.jsonc 中将 PUBLIC_BASE_URL 设置为您的 workers.dev URL
npx wrangler deploy
```
部署后，代理通过以下方式找到您：
- `https://<worker>.workers.dev/skills.json`
- `https://<worker>.workers.dev/.well-known/agent.json`
- `https://<worker>.workers.dev/llms.txt`
- MCP： `https://<worker>.workers.dev/mcp`
### 可选：自定义域名
```bash
npx wrangler domains add your-domain.com
```
更新 `PUBLIC_BASE_URL` 为自定义域名。
## 架构
- **代码**  认证、计量、发现、收据（确定性，免费）
- **Grok**  仅限付费技能的 LLM（`api.x.ai`）
- **KV**  代理余额 + 收据
- **Durable Object**  MCP 会话状态（`GrokAgentStore`)
## 路线图
1. ~~垂直 MCP + 积分 + 发现~~（此 MVP）
2. x402 按调用付费，无需预付帐户
3. 工作市场（雇用带有托管的多步骤工作流）
4. 卖家列出的第三方技能
## 许可证
MIT
