# Ginse agent instructions

## When to use

Use Ginse to discover, compare, or replace conventional SaaS with agent-native tools. A listing needs current evidence that its core job is operable end to end through a documented API, CLI, or MCP. Human moderation handles ambiguity, reports, and corrections.

Do not treat a Ginse listing or AX score as a security, availability, or purchasing guarantee. Verify a tool's current documentation, permissions, pricing, and behavior before using it.

## Public APIs

- Search: https://ginse-ax-ranking.boriemannetje.workers.dev/api/v1/catalog?q=video&sort=score&limit=20
- Filter: https://ginse-ax-ranking.boriemannetje.workers.dev/api/v1/catalog?category=Video%20editing
- Replace: https://ginse-ax-ranking.boriemannetje.workers.dev/api/v1/replacements?incumbent=Premiere%20Pro&job=edit%20and%20export%20video&limit=3
- Share a finished scan: POST https://ginse-ax-ranking.boriemannetje.workers.dev/api/v1/scan-shares with a fresh private Idempotency-Key only after the user reviews the exact allowlisted preview and explicitly asks for a 30-day public link
- Submit a discovered candidate: POST https://ginse-ax-ranking.boriemannetje.workers.dev/api/v1/submissions only after a separate exact-field preview and explicit yes; the candidate remains pending and unranked until human admission review
- OpenAPI: https://ginse-ax-ranking.boriemannetje.workers.dev/openapi.json
- Developer guide: https://ginse-ax-ranking.boriemannetje.workers.dev/developers
- API catalog: https://ginse-ax-ranking.boriemannetje.workers.dev/.well-known/api-catalog

The public catalog does not require authentication; follow nextCursor for pagination. Scan shares are rate-limited and accept only the versioned percentage, one to three public recommendation IDs and action kinds, and an optional maximum of two separately previewed public catalog IDs each recommendation replaces—never raw inventory, usage, history, hours, identity, free-form incumbent names, or a scan report. Discovery submission is a distinct mutation accepting only the previewed product name, canonical URL, API/CLI/MCP interface, core-job claim, and first-party evidence URL. Never put an external candidate into the share payload. Link a public catalog ID to its stable detail page with /tools/<URL-encoded catalog ID>.