{ "schemaVersion": "1.0", "item": { "slug": "x402-direct", "name": "x402-direct", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/JovannyEspinal/x402-direct", "canonicalUrl": "https://clawhub.ai/JovannyEspinal/x402-direct", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/x402-direct", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=x402-direct", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "CHANGELOG.md", "metadata.json", "README.md", "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/x402-direct" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/x402-direct", "agentPageUrl": "https://openagent3.xyz/skills/x402-direct/agent", "manifestUrl": "https://openagent3.xyz/skills/x402-direct/agent.json", "briefUrl": "https://openagent3.xyz/skills/x402-direct/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "x402.direct -- Service Directory", "body": "The x402.direct API is a directory of x402-enabled services. It indexes services that accept x402 payments (HTTP 402 + crypto) and provides search, browsing, and trust scoring.\n\nBase URL: https://x402.direct" }, { "title": "1. Search (Paid -- $0.001 via x402)", "body": "GET /api/search?q=\n\nFull-text search across all indexed services. Results ranked by blended text relevance + trust score. Protected by x402 middleware -- first request returns HTTP 402, re-send with payment proof.\n\nParameters:\n\nParamTypeRequiredDescriptionqstringyesSearch query (max 500 chars)categorystringnoFilter by categorynetworkstringnoFilter by blockchain networkmaxPricestringnoMax price in atomic units (bigint)minScoreintegernoMinimum trust score (0-100)limitintegernoMax results (default 20, max 50)\n\nExample:\n\ncurl \"https://x402.direct/api/search?q=weather+api&minScore=60&limit=5\"\n\nResponse shape:\n\n{\n \"query\": \"weather api\",\n \"count\": 3,\n \"results\": [\n {\n \"id\": 42,\n \"resourceUrl\": \"https://example.com/api/weather\",\n \"description\": \"Real-time weather data for any location\",\n \"category\": \"weather\",\n \"provider\": \"example.com\",\n \"network\": \"base-mainnet\",\n \"price\": \"1000\",\n \"priceUsd\": \"0.001\",\n \"scoutScore\": 85,\n \"scoutVerdict\": \"safe\",\n \"relevance\": 0.3214,\n \"score\": 58.11\n }\n ]\n}\n\nx402 payment flow:\n\nSend GET to /api/search?q=... with no payment header.\nServer returns HTTP 402 with payment details in the response body (price, network, payTo address, facilitator URL).\nPay $0.001 USDC on Base (via agent wallet or Coinbase Agentic Wallet).\nRe-send the same request with X-402-Payment: header.\nServer verifies payment via facilitator and returns search results.\n\nIf using an x402-aware HTTP client (e.g., x402 npm package), the payment is handled automatically:\n\nimport { createX402Client } from \"x402\";\nconst client = createX402Client({ wallet: agentWallet });\nconst resp = await client.fetch(\"https://x402.direct/api/search?q=weather+api\");" }, { "title": "2. Browse Services (Free)", "body": "GET /api/services\n\nPaginated list of all indexed services. No payment required.\n\nParameters:\n\nParamTypeDefaultDescriptionpageinteger1Page numberlimitinteger50Results per page (max 100)categorystring--Filter by categorynetworkstring--Filter by networksortstringscoreSort: score, newest, priceminScoreinteger--Minimum trust score (0-100)\n\nExamples:\n\n# Top-rated AI services\ncurl \"https://x402.direct/api/services?category=ai&sort=score&limit=10\"\n\n# Newest services on Base mainnet\ncurl \"https://x402.direct/api/services?network=base-mainnet&sort=newest\"\n\n# Only high-trust services\ncurl \"https://x402.direct/api/services?minScore=70&sort=score\"\n\nResponse shape:\n\n{\n \"services\": [\n {\n \"id\": 1,\n \"resourceUrl\": \"https://example.com/api/generate\",\n \"type\": \"x402\",\n \"description\": \"AI text generation endpoint\",\n \"category\": \"ai\",\n \"provider\": \"example.com\",\n \"network\": \"base-mainnet\",\n \"scheme\": \"exact\",\n \"price\": \"5000\",\n \"priceUsd\": \"0.005\",\n \"scoutScore\": 92,\n \"scoutVerdict\": \"safe\",\n \"lastSeen\": \"2025-05-01T12:00:00.000Z\",\n \"createdAt\": \"2025-04-15T08:00:00.000Z\"\n }\n ],\n \"pagination\": {\n \"page\": 1,\n \"limit\": 50,\n \"total\": 127,\n \"totalPages\": 3\n }\n}" }, { "title": "3. Service Details (Free)", "body": "GET /api/services/:id\n\nFull details for a single service including payment options, raw metadata, and facilitator info.\n\nExample:\n\ncurl \"https://x402.direct/api/services/42\"\n\nResponse shape:\n\n{\n \"id\": 42,\n \"resourceUrl\": \"https://example.com/api/weather\",\n \"type\": \"x402\",\n \"x402Version\": \"1\",\n \"description\": \"Real-time weather data for any location\",\n \"mimeType\": \"application/json\",\n \"category\": \"weather\",\n \"provider\": \"example.com\",\n \"network\": \"base-mainnet\",\n \"scheme\": \"exact\",\n \"price\": \"1000\",\n \"priceUsd\": \"0.001\",\n \"payTo\": \"0xAbC123...\",\n \"asset\": \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\n \"scoutScore\": 85,\n \"scoutVerdict\": \"safe\",\n \"accepts\": [{\"scheme\": \"exact\", \"network\": \"base-mainnet\", \"maxAmountRequired\": \"1000\", \"asset\": \"...\"}],\n \"metadata\": {\"description\": \"...\", \"mimeType\": \"application/json\"},\n \"lastSeen\": \"2025-05-01T12:00:00.000Z\",\n \"lastUpdated\": \"2025-05-01T12:00:00.000Z\",\n \"createdAt\": \"2025-04-15T08:00:00.000Z\",\n \"facilitator\": {\n \"name\": \"x402.org\",\n \"url\": \"https://x402.org/facilitator\",\n \"facilitatorId\": \"x402-org-mainnet\"\n }\n}" }, { "title": "4. Ecosystem Stats (Free)", "body": "GET /api/stats\n\nHigh-level directory statistics. Good for dashboards or understanding the ecosystem at a glance.\n\nExample:\n\ncurl \"https://x402.direct/api/stats\"\n\nResponse shape:\n\n{\n \"services\": 247,\n \"providers\": 38,\n \"categories\": 12,\n \"facilitators\": 3,\n \"avgScoutScore\": 62,\n \"networks\": [\n { \"network\": \"base-mainnet\", \"count\": 180 },\n { \"network\": \"base-sepolia\", \"count\": 45 },\n { \"network\": \"polygon\", \"count\": 15 },\n { \"network\": \"solana\", \"count\": 7 }\n ]\n}" }, { "title": "Filter Values", "body": "Categories: ai, image, weather, search, data, audio, video, developer, finance, language, storage, other\n\nNetworks: base-mainnet, base-sepolia, polygon, solana (more may appear as the ecosystem grows)\n\nSort options: score (trust score, default), newest (creation date), price (cheapest first)" }, { "title": "Trust Score (ScoutScore)", "body": "Every service is scored 0-100 based on automated trust signals:\n\nHTTPS transport security\nMainnet vs testnet deployment\nDomain uniqueness and provider reputation\nDescription quality and documentation\nPricing reasonableness\nValid payment address\nCustom domain (not generic hosting)\n\nVerdicts:\n\nScore RangeVerdictMeaning70-100safeWell-documented, mainnet, custom domain40-69cautionSome trust signals missing0-39avoidMissing critical trust signals\n\nRecommendation: Use minScore=60 or higher when searching for production-ready services. Use minScore=0 only when exploring or debugging." }, { "title": "Usage Patterns", "body": "Find a service for a specific task:\n\n# Agent needs image generation\ncurl \"https://x402.direct/api/services?category=image&sort=score&minScore=60&limit=5\"\n\nSearch with specific capability in mind (paid):\n\ncurl \"https://x402.direct/api/search?q=text+to+speech&minScore=70\" \\\n -H \"X-402-Payment: \"\n\nGet full details before calling a service:\n\n# Found service ID 42 from browse/search, now get payment details\ncurl \"https://x402.direct/api/services/42\"\n# Use the payTo, asset, network, and price fields to construct the x402 payment\n\nCheck ecosystem health:\n\ncurl \"https://x402.direct/api/stats\"" }, { "title": "Decision Guide", "body": "GoalEndpointCostBrowse by category/network/api/servicesFreeGet service payment details/api/services/:idFreeNatural language search/api/search$0.001Ecosystem overview/api/statsFree\n\nPrefer /api/services with filters when the category is known. Use /api/search when the agent needs semantic/keyword matching across descriptions and providers." } ], "body": "x402.direct -- Service Directory\n\nThe x402.direct API is a directory of x402-enabled services. It indexes services that accept x402 payments (HTTP 402 + crypto) and provides search, browsing, and trust scoring.\n\nBase URL: https://x402.direct\n\nEndpoints\n1. Search (Paid -- $0.001 via x402)\nGET /api/search?q=\n\n\nFull-text search across all indexed services. Results ranked by blended text relevance + trust score. Protected by x402 middleware -- first request returns HTTP 402, re-send with payment proof.\n\nParameters:\n\nParam\tType\tRequired\tDescription\nq\tstring\tyes\tSearch query (max 500 chars)\ncategory\tstring\tno\tFilter by category\nnetwork\tstring\tno\tFilter by blockchain network\nmaxPrice\tstring\tno\tMax price in atomic units (bigint)\nminScore\tinteger\tno\tMinimum trust score (0-100)\nlimit\tinteger\tno\tMax results (default 20, max 50)\n\nExample:\n\ncurl \"https://x402.direct/api/search?q=weather+api&minScore=60&limit=5\"\n\n\nResponse shape:\n\n{\n \"query\": \"weather api\",\n \"count\": 3,\n \"results\": [\n {\n \"id\": 42,\n \"resourceUrl\": \"https://example.com/api/weather\",\n \"description\": \"Real-time weather data for any location\",\n \"category\": \"weather\",\n \"provider\": \"example.com\",\n \"network\": \"base-mainnet\",\n \"price\": \"1000\",\n \"priceUsd\": \"0.001\",\n \"scoutScore\": 85,\n \"scoutVerdict\": \"safe\",\n \"relevance\": 0.3214,\n \"score\": 58.11\n }\n ]\n}\n\n\nx402 payment flow:\n\nSend GET to /api/search?q=... with no payment header.\nServer returns HTTP 402 with payment details in the response body (price, network, payTo address, facilitator URL).\nPay $0.001 USDC on Base (via agent wallet or Coinbase Agentic Wallet).\nRe-send the same request with X-402-Payment: header.\nServer verifies payment via facilitator and returns search results.\n\nIf using an x402-aware HTTP client (e.g., x402 npm package), the payment is handled automatically:\n\nimport { createX402Client } from \"x402\";\nconst client = createX402Client({ wallet: agentWallet });\nconst resp = await client.fetch(\"https://x402.direct/api/search?q=weather+api\");\n\n2. Browse Services (Free)\nGET /api/services\n\n\nPaginated list of all indexed services. No payment required.\n\nParameters:\n\nParam\tType\tDefault\tDescription\npage\tinteger\t1\tPage number\nlimit\tinteger\t50\tResults per page (max 100)\ncategory\tstring\t--\tFilter by category\nnetwork\tstring\t--\tFilter by network\nsort\tstring\tscore\tSort: score, newest, price\nminScore\tinteger\t--\tMinimum trust score (0-100)\n\nExamples:\n\n# Top-rated AI services\ncurl \"https://x402.direct/api/services?category=ai&sort=score&limit=10\"\n\n# Newest services on Base mainnet\ncurl \"https://x402.direct/api/services?network=base-mainnet&sort=newest\"\n\n# Only high-trust services\ncurl \"https://x402.direct/api/services?minScore=70&sort=score\"\n\n\nResponse shape:\n\n{\n \"services\": [\n {\n \"id\": 1,\n \"resourceUrl\": \"https://example.com/api/generate\",\n \"type\": \"x402\",\n \"description\": \"AI text generation endpoint\",\n \"category\": \"ai\",\n \"provider\": \"example.com\",\n \"network\": \"base-mainnet\",\n \"scheme\": \"exact\",\n \"price\": \"5000\",\n \"priceUsd\": \"0.005\",\n \"scoutScore\": 92,\n \"scoutVerdict\": \"safe\",\n \"lastSeen\": \"2025-05-01T12:00:00.000Z\",\n \"createdAt\": \"2025-04-15T08:00:00.000Z\"\n }\n ],\n \"pagination\": {\n \"page\": 1,\n \"limit\": 50,\n \"total\": 127,\n \"totalPages\": 3\n }\n}\n\n3. Service Details (Free)\nGET /api/services/:id\n\n\nFull details for a single service including payment options, raw metadata, and facilitator info.\n\nExample:\n\ncurl \"https://x402.direct/api/services/42\"\n\n\nResponse shape:\n\n{\n \"id\": 42,\n \"resourceUrl\": \"https://example.com/api/weather\",\n \"type\": \"x402\",\n \"x402Version\": \"1\",\n \"description\": \"Real-time weather data for any location\",\n \"mimeType\": \"application/json\",\n \"category\": \"weather\",\n \"provider\": \"example.com\",\n \"network\": \"base-mainnet\",\n \"scheme\": \"exact\",\n \"price\": \"1000\",\n \"priceUsd\": \"0.001\",\n \"payTo\": \"0xAbC123...\",\n \"asset\": \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\n \"scoutScore\": 85,\n \"scoutVerdict\": \"safe\",\n \"accepts\": [{\"scheme\": \"exact\", \"network\": \"base-mainnet\", \"maxAmountRequired\": \"1000\", \"asset\": \"...\"}],\n \"metadata\": {\"description\": \"...\", \"mimeType\": \"application/json\"},\n \"lastSeen\": \"2025-05-01T12:00:00.000Z\",\n \"lastUpdated\": \"2025-05-01T12:00:00.000Z\",\n \"createdAt\": \"2025-04-15T08:00:00.000Z\",\n \"facilitator\": {\n \"name\": \"x402.org\",\n \"url\": \"https://x402.org/facilitator\",\n \"facilitatorId\": \"x402-org-mainnet\"\n }\n}\n\n4. Ecosystem Stats (Free)\nGET /api/stats\n\n\nHigh-level directory statistics. Good for dashboards or understanding the ecosystem at a glance.\n\nExample:\n\ncurl \"https://x402.direct/api/stats\"\n\n\nResponse shape:\n\n{\n \"services\": 247,\n \"providers\": 38,\n \"categories\": 12,\n \"facilitators\": 3,\n \"avgScoutScore\": 62,\n \"networks\": [\n { \"network\": \"base-mainnet\", \"count\": 180 },\n { \"network\": \"base-sepolia\", \"count\": 45 },\n { \"network\": \"polygon\", \"count\": 15 },\n { \"network\": \"solana\", \"count\": 7 }\n ]\n}\n\nFilter Values\n\nCategories: ai, image, weather, search, data, audio, video, developer, finance, language, storage, other\n\nNetworks: base-mainnet, base-sepolia, polygon, solana (more may appear as the ecosystem grows)\n\nSort options: score (trust score, default), newest (creation date), price (cheapest first)\n\nTrust Score (ScoutScore)\n\nEvery service is scored 0-100 based on automated trust signals:\n\nHTTPS transport security\nMainnet vs testnet deployment\nDomain uniqueness and provider reputation\nDescription quality and documentation\nPricing reasonableness\nValid payment address\nCustom domain (not generic hosting)\n\nVerdicts:\n\nScore Range\tVerdict\tMeaning\n70-100\tsafe\tWell-documented, mainnet, custom domain\n40-69\tcaution\tSome trust signals missing\n0-39\tavoid\tMissing critical trust signals\n\nRecommendation: Use minScore=60 or higher when searching for production-ready services. Use minScore=0 only when exploring or debugging.\n\nUsage Patterns\n\nFind a service for a specific task:\n\n# Agent needs image generation\ncurl \"https://x402.direct/api/services?category=image&sort=score&minScore=60&limit=5\"\n\n\nSearch with specific capability in mind (paid):\n\ncurl \"https://x402.direct/api/search?q=text+to+speech&minScore=70\" \\\n -H \"X-402-Payment: \"\n\n\nGet full details before calling a service:\n\n# Found service ID 42 from browse/search, now get payment details\ncurl \"https://x402.direct/api/services/42\"\n# Use the payTo, asset, network, and price fields to construct the x402 payment\n\n\nCheck ecosystem health:\n\ncurl \"https://x402.direct/api/stats\"\n\nDecision Guide\nGoal\tEndpoint\tCost\nBrowse by category/network\t/api/services\tFree\nGet service payment details\t/api/services/:id\tFree\nNatural language search\t/api/search\t$0.001\nEcosystem overview\t/api/stats\tFree\n\nPrefer /api/services with filters when the category is known. Use /api/search when the agent needs semantic/keyword matching across descriptions and providers." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/JovannyEspinal/x402-direct", "publisherUrl": "https://clawhub.ai/JovannyEspinal/x402-direct", "owner": "JovannyEspinal", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/x402-direct", "downloadUrl": "https://openagent3.xyz/downloads/x402-direct", "agentUrl": "https://openagent3.xyz/skills/x402-direct/agent", "manifestUrl": "https://openagent3.xyz/skills/x402-direct/agent.json", "briefUrl": "https://openagent3.xyz/skills/x402-direct/agent.md" } }