80trust / 100

Docs Snippet

by docs-snippet in Productivity & SaaS

x402 APIPassing, checked 2 h ago

Working code snippets for a library, matched to a topic. Give an ecosystem, package name and a topic or symbol and get the fenced code blocks from the README or docs whose language, code or nearest heading matches, each with a source citation and an honest truncated flag. Ideal for grounding a coding agent in real usage examples.

GET https://api.agentstools.dev/docs/snippet

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
33 ms typical, 33 ms slowest 5%
Last check
2 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X GET "https://api.agentstools.dev/docs/snippet?ecosystem=npm&name=axios&topic=request"
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.agentstools.dev%2Fdocs%2Fsnippet
const res = await pay("https://api.agentstools.dev/docs/snippet?ecosystem=npm&name=axios&topic=request");
console.log(await res.json());

Example input

{
  "ecosystem": "npm",
  "name": "axios",
  "topic": "request"
}

Example output

{
  "attribution": [
    "npm public registry (registry.npmjs.org)."
  ],
  "capped": true,
  "count": 2,
  "found": true,
  "identity": {
    "ecosystem": "npm",
    "name": "axios",
    "resolved_version": "1.7.9"
  },
  "snippets": [
    {
      "code": "const res = await axios.get('/user?ID=12345')",
      "heading": "Example",
      "language": "js",
      "provenance": {
        "source": "npm",
        "source_url": "https://www.npmjs.com/package/axios",
        "version": "1.7.9"
      },
      "truncated": false
    }
  ],
  "topic": "request"
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
2 h agoPassed402101 ms$0.008
7 h agoPassed40233 ms$0.008