# Netzhandwerker API Discovery Tool

> Netzhandwerker API Discovery Tool is a paid API for AI agents from tools.netzhandwerker.de, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Probes a given domain to discover its machine-readable API interfaces, agent capabilities, and structured metadata endpoints

## Facts

- Endpoint: POST https://tools.netzhandwerker.de/v1/api/discovery
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/netzhandwerker-api-discovery-tool-9fbb2adf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Hqe3pXUA_cMlnpoGfNhAf

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability netzhandwerker-api-discovery-tool-9fbb2adf -d '<json body>'
```

Example prompt: Can you scan stripe.com and tell me what machine-readable APIs or agent-friendly interfaces it exposes — like OpenAPI specs, llms.txt, or x402 support?

## When to prefer this

Use this endpoint when an agent needs to programmatically discover what APIs, structured data, or agent-ready capabilities a domain exposes before attempting integration. Prefer it over manual documentation lookup when you need a structured, machine-parseable inventory of a domain's interfaces. Ideal for agent onboarding flows, competitive API research, or checking x402/MCP/OpenAPI support on an unknown domain.

## Known failure modes

- Domain does not exist or is unreachable — returns empty interfaces array with error status
- Domain blocks crawlers via robots.txt — some paths may return 403 or 404
- No machine-readable interfaces found — returns found_count of 0 with empty interfaces
- Malformed domain input — may return validation error
- Rate limiting by target domain — partial results or timeout
- Non-standard API paths not discoverable — note in response warns undocumented interfaces remain invisible

## How this service works

x402-Werkzeuge für autonome Agenten.

## Output

Returns a JSON object containing: the domain's base URL, homepage metadata (title, HTTP status, JSON-LD types, link relations), a list of discovered interfaces (OpenAPI, robots.txt, sitemap, llms.txt) with URLs, byte sizes, HTTP status codes, and parsed summaries, capability flags (x402, MCP, GraphQL, feeds, OpenAPI, llms.txt, structured data), total count of probed paths, and an agent_readiness_score integer.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "domain": {
   "type": "string",
   "description": "Domain oder URL, zum Beispiel example.com"
  },
  "include_probe_log": {
   "type": "boolean",
   "default": false,
   "description": "Alle geprueften Pfade mit Statuscode mitliefern"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Nur bekannte Konventionspfade und Verweise der Startseite. Nicht dokumentierte Schnittstellen bleiben unsichtbar.",
  "kinds": [
   "openapi",
   "robots_txt",
   "sitemap",
   "llms_txt"
  ],
  "domain": "stripe.com",
  "probed": 26,
  "base_url": "https://stripe.com",
  "homepage": {
   "title": "Stripe",
   "status": 200,
   "generator": null,
   "link_rels": [],
   "link_header": null,
   "json_ld_types": [
    "Organization"
   ],
   "payment_header": false
  },
  "interfaces": [
   {
    "url": "https://stripe.com/openapi.json",
    "kind": "openapi",
    "bytes": 1840233,
    "status": 200,
    "summary": {
     "title": "Stripe API",
     "methods": [
      "GET",
      "POST",
      "DELETE"
     ],
     "version": "2026-06-30",
     "path_count": 512,
     "auth_schemes": [
      "bearerAuth"
     ],
     "paths_sample": [
      "/v1/charges",
      "/v1/customers"
     ],
     "spec_version": "3.0.0"
    },
    "content_type": "application/json"
   },
   {
    "url": "https://stripe.com/robots.txt",
    "kind": "robots_txt",
    "bytes": 812,
    "status": 200,
    "summary": {
     "lines": 34,
     "sitemaps": [
      "https://stripe.com/sitemap.xml"
     ],
     "user_agents": [
      "*",
      "GPTBot"
     ]
    },
    "content_type": "text/plain"
   }
  ],
  "found_count": 4,
  "capabilities": {
   "mcp": false,
   "x402": false,
   "feeds": false,
   "graphql": false,
   "openapi": true,
   "llms_txt": true,
   "structured_data": true,
   "machine_readable": true
  },
  "agent_readiness_score": 47
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/netzhandwerker-api-discovery-tool-9fbb2adf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tools.netzhandwerker.de](https://www.zero.xyz/host/tools.netzhandwerker.de/llms.txt)