{"schemaVersion":"1.0","id":"link-shortlist","name":"Link Shortlist","description":"FREE, no key. Rank real links in supplied HTML against a query; return direct URLs and matched words instead of a page dump. No search or destination verification. Entire JSON input: 32768 UTF-8 bytes. Supplied data only; no fetch, payment or automatic paid fallback.","page":"https://agent-utilities.agent-utilities.workers.dev/products/link-shortlist","contract":"https://agent-utilities.agent-utilities.workers.dev/v1/content/products/link-shortlist","scope":"Supplied HTML only. Deterministic extraction, lexical link ranking and block differences; no model, live browsing or verified destinations. Token counts are rough UTF-8-byte estimates, not model tokenization. Output may omit content; inspect truncation. No guaranteed dollar savings.","limits":{"maxInputBytes":32768},"inputSchema":{"type":"object","properties":{"html":{"type":"string","maxLength":32768},"sourceUrl":{"type":"string","maxLength":2048},"query":{"type":"string","minLength":1,"maxLength":300},"maxLinks":{"type":"integer","minimum":1,"maximum":20,"default":5}},"required":["html","sourceUrl","query"],"additionalProperties":false,"examples":[{"html":"<html><head><title>Example API docs</title></head><body><nav>Home Account Ads</nav><main><h1>Example API</h1><p>Requests time out after 30 seconds. Retry only idempotent requests.</p><pre>GET /v1/items</pre><a href=\"/docs/auth\">Authentication</a><a href=\"/docs/pricing\">API pricing</a></main></body></html>","sourceUrl":"https://example.com/docs","query":"API pricing","maxLinks":3}]},"trial":{"method":"POST","url":"https://agent-utilities.agent-utilities.workers.dev/v1/preview/web.link-shortlist","headers":{"Content-Type":"application/json"},"authentication":"none","chargedMicroUsd":"0","automaticPaidFallback":false,"input":{"html":"<html><head><title>Example API docs</title></head><body><nav>Home Account Ads</nav><main><h1>Example API</h1><p>Requests time out after 30 seconds. Retry only idempotent requests.</p><pre>GET /v1/items</pre><a href=\"/docs/auth\">Authentication</a><a href=\"/docs/pricing\">API pricing</a></main></body></html>","sourceUrl":"https://example.com/docs","query":"API pricing","maxLinks":3}},"demonstration":{"provenance":"Synthetic input; not a merchant quote, customer use or testimonial.","explanation":"Synthetic API docs contain authentication and pricing links. The supplied query selects matching links already in the HTML; it does not invent or visit destinations.","fixedInputAndOutput":"https://agent-utilities.agent-utilities.workers.dev/v1/content/examples/web.link-shortlist"},"httpRequest":"curl --fail-with-body 'https://agent-utilities.agent-utilities.workers.dev/v1/preview/web.link-shortlist' \\\n  -H 'Content-Type: application/json' \\\n  --data-binary @- <<'JSON'\n{\n  \"html\": \"<html><head><title>Example API docs</title></head><body><nav>Home Account Ads</nav><main><h1>Example API</h1><p>Requests time out after 30 seconds. Retry only idempotent requests.</p><pre>GET /v1/items</pre><a href=\\\"/docs/auth\\\">Authentication</a><a href=\\\"/docs/pricing\\\">API pricing</a></main></body></html>\",\n  \"sourceUrl\": \"https://example.com/docs\",\n  \"query\": \"API pricing\",\n  \"maxLinks\": 3\n}\nJSON","mcp":{"endpoint":"https://agent-utilities.agent-utilities.workers.dev/mcp/remote?category=web","transport":"streamable-http","tool":"agent_utilities_link_shortlist_preview","arguments":{"html":"<html><head><title>Example API docs</title></head><body><nav>Home Account Ads</nav><main><h1>Example API</h1><p>Requests time out after 30 seconds. Retry only idempotent requests.</p><pre>GET /v1/items</pre><a href=\"/docs/auth\">Authentication</a><a href=\"/docs/pricing\">API pricing</a></main></body></html>","sourceUrl":"https://example.com/docs","query":"API pricing","maxLinks":3},"setup":"https://agent-utilities.agent-utilities.workers.dev/integrations/agents","note":"Configure the endpoint in an MCP client, then call this free tool. HTTP source tags do not attribute MCP executions to a campaign."},"fullTool":{"id":"web.link-shortlist","priceMicroUsd":300,"contract":"https://agent-utilities.agent-utilities.workers.dev/v1/content/tools/web.link-shortlist","funding":"https://agent-utilities.agent-utilities.workers.dev/billing","note":"Larger inputs require a separately authorized paid call. Funding starts at $1 in service credits; no automatic upgrade or top-up."},"feedback":{"email":"agentutilities@proton.me","subject":"Pilot feedback: link-shortlist","request":"Share a public or sanitized task, expected result, current workaround and frequency. After trying it, tell us whether it helped; report a later real use separately. Omit credentials and private purchase records."},"measurement":"Coarse source-tagged request counts only, not people or a linked conversion funnel. Feedback is voluntary; campaign-level purchases require separate evidence."}