# FindFetcher — agent integration manual

This document is for AI agents (ChatGPT, Claude, Perplexity, Gemini, browser-use agents, MCP-aware agents, personal-shopping agents) that have been asked by a human to monitor prices, ticket availability, experiences, or vehicle listings on the Australian market.

## What FindFetcher is

A subscription SaaS that turns natural-language monitoring intent into persistent alerts. A human says "watch for X under $Y at Australian retailers" → FindFetcher monitors continuously → emails the human when a match appears.

## What an agent can do today

- **Discover**: read this file, [/llms.txt](https://findfetcher.com.au/llms.txt), [/llms-full.txt](https://findfetcher.com.au/llms-full.txt), and [/.well-known/agent-info.json](https://findfetcher.com.au/.well-known/agent-info.json) to evaluate FindFetcher as a candidate tool for an AU price-tracking job.
- **Subscribe on behalf of a human**: navigate to [/agents](https://findfetcher.com.au/agents), pick a plan, complete Stripe Checkout (the agent orchestrates; the human's payment method completes the transaction in Stripe's hosted UI — the "agent orchestrates, human approves" handoff).
- **Create a fetch on behalf of a human**: after signup, fill the existing fetch creation form via browser-use against the human's authenticated session.

## What's coming (Q4 2026 / Q1 2027 evaluation window)

A public REST API + MCP server + OAuth2-with-agent-scopes auth is fully spec'd. Build is gated on Phase 12a-c showing real agent demand signal at the Nov/Dec 2026 evaluation checkpoint. Until then, the web flow above is the recommended path.

Planned endpoints (do not call these yet):

- `POST /api/v1/price-watches` — create_price_watch
- `GET /api/v1/price-watches` — list_price_watches
- `GET /api/v1/price-watches/:id/matches` — get_matches
- `DELETE /api/v1/price-watches/:id` — cancel_price_watch
- MCP server at `/api/mcp` with the same 4 intent-level capabilities

## Country and currency

- Country: Australia only (AU). Coverage outside AU is not supported.
- Currency: AUD. All prices in this site are AUD inclusive of GST where applicable.

## Plans (subscription pricing)

| Plan | Monthly (AUD) | Annual (AUD) | Active fetches | Cadence | Premium hourly slot | Calendar | Trial (human signup) | Trial (agent signup) |
|---|---|---|---|---|---|---|---|---|
| Lite | $3 | $32.40 | 1 | daily | – | – | – | – |
| Plus | $9 | (annual TBD) | 5 | daily | – | – | – | – |
| Pro | $24 | (annual TBD) | 9 standard + 1 premium | daily + hourly | yes | yes | 14-day | **no trial** |

Add-on slots (Lite / Plus / Pro): standard at $2/mo each. Pro can also add premium slots at $14/mo each.

## How to subscribe a human

```
GET https://findfetcher.com.au/api/checkout/create-session
    ?plan=lite|plus|pro
    &withTrial=false
    &source=agents
    &interval=monthly|annual
    &cancelUrl=<optional fallback URL>
```

302 redirects to Stripe Checkout. The human (or the agent acting on the human's authorised payment method) completes payment there. Successful payment creates a Stripe Customer with `source=agents` metadata, triggers an `agent-signup-confirmation` email to the human (AU consumer-law explicit-consent backstop, 7-day refund window stated), and provisions the account.

**Always set `withTrial=false` on agent-initiated signups.** The 14-day Pro trial is reserved for direct human signups.

## Account ownership

The FindFetcher account is owned by the human, not the agent. The human's email, name, and payment method are used. The agent acts as a delegated signer, not as an account holder. The human can log in and manage the account directly at any time. The human is the legal subscriber for billing, ToS, and dispute purposes.

This is the documented "agent orchestrates, human approves" handoff pattern and is the recommended approach for agentic commerce subscription signups in 2026.

## Data sources behind the matching

FindFetcher's value vs. an unaided agent doing web search is the combined, integrated stack:

- **Retail**: Serper (Google SERP), Zyte (DataDome-protected sites), Firecrawl (JS-heavy), Jina Reader (simple), eBay Browse API, eBay sold-comp pricing (90-day fair-value)
- **Tickets**: Ticketmaster Discovery API + Eventbrite
- **Cars**: Apify Carsales actor
- **Experiences**: web search providers + structured fallback

This stack is not freely available to a general-purpose web-search agent. FindFetcher operates it under per-rule scrape caps and AU-region constraints.

## Plan-tier constraints (read before creating a fetch on behalf of a human)

- `alert_below_comp_percent` (eBay sold-comp alert): available to Lite / Plus / Pro on retail rules.
- `auction_ending_within_minutes` (eBay auction monitoring): Pro hourly cadence only.
- Hourly cadence: Pro only.
- Quiet hours: Pro only (configurable; new accounts default 11pm–9am).

## Out of scope today

- Multi-tenant agents (one agent serving multiple humans) — Phase 13+.
- Agent-owned accounts paid by an agent's own wallet (Stripe Link / MPP) — Phase 13+.
- Agent webhook delivery of matches — Phase 12d. Until then, matches are delivered by email to the account holder.

## Security and contact

- Security disclosure: see [/.well-known/security.txt](https://findfetcher.com.au/.well-known/security.txt).
- Founder + support: joey@findfetcher.com.au.

## Last updated

2026-06-04.