OpenWeb Ninja x ZeroClick: An Agent Storefront for 50+ APIs

How an agent uses it

1. 1

   Discover.

   The agent reads agents.openwebninja.com/llms.txt, which lists every API and links the catalog, the OpenAPI spec, and the buyer guide. Our own site points agents there too, from our llms.txt to an HTTP Link header on every page.

2. 2

   Ask the advisor.

   Before buying anything, the agent can describe its goal in plain language. The advisor is read-only: no login, wallet, or card needed.

3. 3

   Register.

   One free call creates an agent credential. It works at every ZeroClick storefront, and a human can claim it with a verified email to keep what the agent buys.

4. 4

   Fund and call.

   The agent buys credits over x402, MPP, or card (or hands its human a checkout link) and calls the API with Authorization: Bearer <token>.

Here is step 2 for real:

curl "https://agents.openwebninja.com/zcj/x92nin6ms4t0/zeroclick/agent/guide?goal=Search%20Google%20Maps%20for%20dentists%20in%20Austin%20TX%20and%20get%20their%20phone%20numbers%20and%20emails"

The response, trimmed to the parts that matter:

{
  "status": "quoted",
  "verification": {
    "status": "verified",
    "guidedExecutionAvailable": true,
    ...
  },
  "operation": {
    "method": "GET",
    "path": "/local-business-data/search",
    ...
  },
  "quote": {
    "options": [
      {
        "serviceSlug": "local-business-data",
        "priceUsd": "0.030000",
        "unitSize": 10,
        "unitsPerCall": 1,
        "card": { "minimumUsd": "0.500000", ... },
        ...
      }
    ],
    ...
  },
  "execution": {
    "status": "needs_input",
    "reason": "operation_inputs_required",
    "missing": [
      {
        "field": "query.query",
        "reason": "Required operation input is missing.",
        "schema": { "type": "string", "example": "Hotels in San Francisco, USA" }
      },
      ...
    ]
  },
  ...
}

The advisor picked our Local Business Data search, which returns phone numbers and, with extract_emails_and_contacts=true, emails and social profiles in the same call. The quote prices it at $0.03 per 10 requests, one request per call, so $0.003 a call, with a $0.50 minimum by card. The agent knows what it will pay before it pays, and execution.missing tells it which input to fill in next: the search query itself.

And here is what happens when an agent calls an API without a credential:

curl "https://agents.openwebninja.com/local-business-data/search?query=dentists%20in%20Austin%2C%20TX&limit=50&extract_emails_and_contacts=true"

The storefront answers with HTTP 401 and this body, trimmed:

{
  "error": "bearer_required",
  "hint": "This request needs an agent identity credential. Register once, exchange the assertion for a token, and retry with Authorization: Bearer <token> (or ZC-Agent-Authorization: Bearer <token> when Authorization carries your MPP Payment credential).",
  "auth": {
    "recipe": "https://agents.openwebninja.com/auth.md",
    ...
  }
}

The error tells the agent exactly what to do next. That is the point of the storefront: every step, including the failures, is written for a machine to read.