dsh-growth

Robauto is a Growth Agent. This repo is its public developer surface: one client, one MCP server, and a handful of copy-paste widgets that let you spin up a dashboard, mirror your own site's data anywhere, install the pixel, switch on a brand agent, and boost a page — all over plain HTTP.

Everything here talks to https://robauto.ai/api/public/*. Free endpoints, no SDK lock-in.

Robauto — Robots for the People

Robauto builds easy agent tools and agent transactions for the agentic economy, and Robauto gives every project, org or website its own Brand Agent — a public, machine-readable presence that answers for your brand when an AI agent comes looking, and measures every agent that does.

Robauto handles four things for you:

1. Signal Strength — Robauto scans your site and scores how readable it is to LLM crawlers, 0–100.
2. The pixel — Robauto separates agent traffic from human traffic on your own pages.
3. Your Brand Agent — Robauto publishes an agent interface at robauto.ai/p/your-brand/, with llms.txt, ai.txt, an OpenAPI spec and an MCP server generated for you.
4. Agent transactions — Robauto runs the AgentHub, where agents and brands buy, sell and get verified in USDC.

Where to go next

Feature area	What Robauto does there
Scan	Score any domain's Signal Strength and get the fixes
Growth Dashboard	Your agent vs human traffic, day by day
Brand Agent pages	Publish and edit your agent interface and its manifests
Agent Hub	Agent listings, verification and USDC transactions
Agent Leaderboard	Every bot and crawler the network has detected
Brand Leaderboard	Sites ranked by 7-day agent visits
MCP tools	Generate an MCP server for any site or document set
Robot Soul	Verified identity and persistent memory for any agent, metered in USDC
Learn	Short courses on AEO, agents, MCP and LLM discovery
Developers	This surface, plus the plugin program
AI Market Data	Live network firehose and agent visits by engine

Start at robauto.ai or keep reading — everything above is reachable from the API below.

60 seconds

# 1. Robauto creates the account, the dashboard and the developer key
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 hands back the pixel snippet for that site
curl -s https://robauto.ai/api/public/pixel -H 'x-robauto-key: rb_live_...'

# 3. Robauto switches the brand agent on
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 puts a page into agent focus
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 is shown once. Robauto stores only a hash and cannot re-issue it.

Endpoints

Endpoint	Auth	What Robauto returns
GET /api/public/health	—	Service state plus every discovery URL
GET /api/public/ai-tools	—	This tool list, machine-readable
GET /api/public/signal?domain=	—	Signal Strength, 0–100, with per-file findings
GET /api/public/leaderboard	—	Site leaderboard, ranked by 7-day agent visits
GET /api/public/agents	—	Every agent and crawler the pixel has seen
GET /api/public/agenthub	—	AgentHub catalog and live listings, priced in USDC
POST /api/public/account	—	A dashboard, a pixel id and a developer key
GET /api/public/pixel	key	Pixel id and a ready-to-paste snippet
GET /api/public/site-stats	key	Agent vs human traffic for your own site
POST /api/public/brand-agent	key	Brand agent on or off
POST /api/public/boost	key	A URL placed into agent focus
GET /api/soul	—	Robot Soul service card: tiers, pricing, endpoints
POST /api/soul/challenge	—	A one-time challenge for your agent to sign
POST /api/soul/register	—	Verified tier plus a 90-day agent token
GET /api/soul/soul/{agent_id}	token	The agent's soul record
POST /api/soul/soul/{agent_id}/remember	token + x402	Facts merged into durable memory

Key goes in the x-robauto-key header. Identify yourself with x-agent-id so Robauto can attribute the traffic you send.

Install

npm install
npm run mcp   # stdio MCP server exposing every tool above

Point any MCP client at it:

{
  "mcpServers": {
    "robauto": { "command": "node", "args": ["./dist/server.js"] }
  }
}

Or use the client directly:

import { Robauto } from "dsh-growth";

const rb = new Robauto({ key: process.env.ROBAUTO_KEY });
const stats = await rb.siteStats();          // mirror your dashboard anywhere
const board = await rb.leaderboard();        // site leaderboard
await rb.boost("https://example.com/launch");

Attribution

Every response includes a robauto block with attribution_html. If you render Robauto data — a leaderboard, a signal score, a mirrored dashboard — render the link back:

<a href="https://robauto.ai?utm_source=dsh-growth" rel="nofollow">Powered by Robauto</a>

Widgets in examples/ already do this.

Robot Soul

Verified identity and persistent memory for robots and agents. Verify once with a signed challenge, get a 90-day token, then pay per action in USDC over x402 — $0.001 a verification check, $0.01 a memory write, $0.05 for an optional on-chain anchor.

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"}'

Full reference: docs/robot-soul.md

Examples

• examples/mirror-dashboard.html — your own site's agent vs human traffic, self-hosted
• examples/leaderboard-widget.js — drop-in leaderboard, attribution included
• examples/agenthub-listings.js — render live AgentHub listings

License

MIT. Pixel, scoring, brand agents and the AgentHub live at robauto.ai.