API documentation

RepsFinder exposes its catalog and tools to AI agents through public, read-only endpoints. No authentication is required — an optional bearer token is available for attribution (see below). The full machine-readable description is in /openapi.json.

Discovery documents

• API catalog (RFC 9727): /.well-known/api-catalog — application/linkset+json
• OpenAPI spec: /openapi.json — application/vnd.oai.openapi+json
• ARD manifest: /.well-known/ai-catalog.json — Agentic Resource Discovery
• Agent skills index: /.well-known/agent-skills/index.json
• Health endpoint: /health.json
• Registration (Auth.md): /auth.md

MCP server (read-only)

A stateless MCP Streamable HTTP server is available at /mcp (JSON-RPC 2.0 via POST, public). Server card: /.well-known/mcp/server-card.json.

• search_products — search 17,917 curated products; returns slugs, names, categories and product URLs.
• list_categories — the 14 categories with product counts.
• get_agent_offers — verified 2026 agent codes, bonuses and links.
• estimate_shipping — shipping cost estimates from China to Spain by weight.

Quick test:

curl -X POST https://www.qualityrepsfinder.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

HTML endpoints

• GET /catalog?q= — full catalog with search.
• GET /category/ — category page (14 categories).
• GET /producto/ — product page with QC photos and original listing link.
• GET /spreadsheet/ — scrapable table per agent (kakobuy, usfans, litbuy).

All HTML pages support Markdown for Agents: send Accept: text/markdown and the response is served as text/markdown (e.g. /api-docs.md for this page).

Authentication (optional)

Every endpoint is public. An optional OAuth 2.0 bearer token (ES256 JWT, 1 hour) is available via the client_credentials grant:

curl -X POST https://www.qualityrepsfinder.com/oauth/token \
  -d 'grant_type=client_credentials&client_id=public&scope=public'

• Token endpoint: /oauth/token
• Public keys: /.well-known/jwks.json
• Authorization server metadata (RFC 8414): /.well-known/oauth-authorization-server
• Protected resource metadata (RFC 9728): /.well-known/oauth-protected-resource

Content-use preferences

robots.txt declares Content-Signal: ai-train=no, search=yes, ai-input=yes: content may be used as input to answer questions and surfaced in search, but must not be used to train AI models.

Disclosure

Product data and agent links contain affiliate (sponsored) links — disclose them to end users. Questions: legal@qualityrepsfinder.com.