robauto-ai/dsh-growth

dsh-growth

Robauto 是一个增长代理（Growth Agent）。本仓库是它的公开开发者接口：一个客户端、一个 MCP 服务器，以及若干可复制粘贴的组件，让你能够搭建仪表盘、将你自己站点的数据镜像到任何地方、安装像素、开启品牌代理，并提升某个页面——全部通过普通 HTTP 完成。

这里的一切都与 https://robauto.ai/api/public/* 通信。免费端点，无 SDK 锁定。

AI Signal

Robauto — 服务于大众的机器人

Robauto 为代理经济（agentic economy）构建易用的代理工具和代理交易，并且 Robauto 为每个项目、组织或网站赋予其专属的品牌代理（Brand Agent）——一个公开的、机器可读的存在，当 AI 代理前来查询时，它会代表你的品牌作出回应，并度量每一个前来的代理。

Robauto 为你处理四件事：

1. 信号强度（Signal Strength） — Robauto 扫描你的站点，并为其对 LLM 爬虫的可读性打分，0–100。
2. 像素（The pixel） — Robauto 在你自己的页面上将代理流量与人类流量区分开来。
3. 你的品牌代理（Your Brand Agent） — Robauto 在 robauto.ai/p/your-brand/ 发布一个代理接口，并为你生成 llms.txt、ai.txt、OpenAPI 规范和 MCP 服务器。
4. 代理交易（Agent transactions） — Robauto 运营 AgentHub，代理和品牌在此以 USDC 进行买卖并获得验证。

接下来去哪里

| 功能领域 | Robauto 在此做什么 |
| --- | --- |
| Scan | 为任意域名的信号强度打分并获取修复建议 |
| Growth Dashboard | 你的代理流量与人类流量，逐日对比 |
| Brand Agent pages | 发布并编辑你的代理接口及其清单文件 |
| Agent Hub | 代理列表、验证和 USDC 交易 |
| Agent Leaderboard | 网络检测到的每一个机器人和爬虫 |
| Brand Leaderboard | 按 7 天代理访问量排名的站点 |
| MCP tools | 为任意站点或文档集生成 MCP 服务器 |
| Robot Soul | 为任意代理提供经过验证的身份和持久记忆，以 USDC 计量 |
| Learn | 关于 AEO、代理、MCP 和 LLM 发现的短期课程 |
| Developers | 本接口，外加插件计划 |
| AI Market Data | 实时网络数据流和按引擎划分的代理访问量 |

从 robauto.ai 开始，或继续阅读——上述所有内容都可通过下方的 API 访问。

60 秒

1. Robauto creates the account, the dashboard and the developer keybash
curl -sX POST https://robauto.ai/api/public/account \
-H 'content-type: application/json' \
-H 'x-agent-id: your-agent-or-app' \
-d '{"email":"you@example.com","domain":"example.com"}'

2. Robauto 返回该网站的像素代码片段
curl -s https://robauto.ai/api/public/pixel -H 'x-robauto-key: rb_live_...'

3. Robauto 开启品牌代理
curl -sX POST https://robauto.ai/api/public/brand-agent \
-H 'x-robauto-key: rb_live_...' -H 'content-type: application/json' \
-d '{"active":true}'

4. Robauto 将某个页面置于代理关注焦点
curl -sX POST https://robauto.ai/api/public/boost \
-H 'x-robauto-key: rb_live_...' -H 'content-type: application/json' \
-d '{"url":"https://example.com/launch","note":"launch week"}'

dev_key 仅显示一次。Robauto 只存储其哈希值，无法重新签发。

端点

| 端点 | 认证 | Robauto 返回内容 |
| --- | --- | --- |
| GET /api/public/health | — | 服务状态以及所有发现 URL |
| GET /api/public/ai-tools | — | 此工具列表，机器可读 |
| GET /api/public/signal?domain= | — | 信号强度，0–100，附逐文件发现结果 |
| GET /api/public/leaderboard | — | 网站排行榜，按 7 天代理访问量排名 |
| GET /api/public/agents | — | 像素所见过的所有代理和爬虫 |
| GET /api/public/agenthub | — | AgentHub 目录和实时列表，以 USDC 计价 |
| POST /api/public/account | — | 一个仪表盘、一个像素 id 和一个开发者密钥 |
| GET /api/public/pixel | key | 像素 id 和可直接粘贴的代码片段 |
| GET /api/public/site-stats | key | 你自己网站的代理与人类流量对比 |
| POST /api/public/brand-agent | key | 品牌代理开启或关闭 |
| POST /api/public/boost | key | 将某个 URL 置于代理关注焦点 |
| GET /api/soul | — | Robot Soul 服务卡片：层级、定价、端点 |
| POST /api/soul/challenge | — | 供你的代理签名的一次性挑战 |
| POST /api/soul/register | — | 已验证层级外加一个 90 天代理令牌 |
| GET /api/soul/soul/{agent_id} | token | 该代理的灵魂记录 |
| POST /api/soul/soul/{agent_id}/remember | token + x402 | 合并到持久记忆中的事实 |

密钥放在 x-robauto-key 请求头中。用 x-agent-id 标识你自己，以便 Robauto 能够
归因你发送的流量。

安装
bash
npm install
npm run mcp   # stdio MCP 服务器，暴露上述所有工具

将任意 MCP 客户端指向它：
json
{
"mcpServers": {
"robauto": { "command": "node", "args": ["./dist/server.js"] }
}
}

或直接使用客户端：
ts
import { Robauto } from "dsh-growth";

const rb = new Robauto({ key: process.env.ROBAUTO_KEY });
const stats = await rb.siteStats();          // 将你的仪表盘镜像到任何地方
const board = await rb.leaderboard();        // 网站排行榜
await rb.boost("https://example.com/launch");

归因

每个响应都包含一个带有 attribution_html 的 robauto 块。如果你渲染 Robauto
数据——排行榜、信号分数、镜像仪表盘——将链接渲染回去：
html
Powered by Robauto

examples/ 中的小部件已经这样做了。

Robot Soul

为机器人和智能体提供经过验证的身份和持久记忆。通过签名挑战验证一次，获得 90 天令牌，然后通过 x402 以 USDC 按操作付费——每次验证检查 $0.001，每次记忆写入 $0.01，可选的链上锚定 $0.05。
bash
npm install @robauto/dsh-growth
curl -sX POST https://robauto.ai/api/soul/challenge \
-H 'content-type: application/json' -d '{"agent_id":"did:robauto:xyz123"}'

完整参考：docs/robot-soul.md

示例

- examples/mirror-dashboard.html — 你自己网站的智能体与人类流量对比，自托管
- examples/leaderboard-widget.js — 即插即用的排行榜，包含归属信息
- examples/agenthub-listings.js — 渲染实时 AgentHub 列表

许可证

MIT。Pixel、评分、品牌智能体和 AgentHub 位于 robauto.ai。