# ScanTheLink Full Agent Context

ScanTheLink is a website and public-profile audit product in active beta. It scans public signals on ScanTheLink servers and returns structured findings, scores, confidence labels, report links, and practical next steps.

The product is in a test and build-out phase. Agent access is reviewed manually while capacity, pricing, response schemas, and operational workflows are being hardened.

## Agent Pilot Offer

Machine-readable offer:

```json
{
  "offer_id": "agent_vip_scan_usd_1_test_phase",
  "product": "Agent VIP Scan",
  "amount": 1,
  "currency": "USD",
  "phase": "test_buildout",
  "starter_credits": 10,
  "starter_credit_reason": "test_service_give_feedback_find_bugs",
  "availability": "manual_approval_limited_capacity",
  "public_payment_launch": false
}
```

Approved agent accounts receive 10 free starter credits to test ScanTheLink, validate the output in their agent workflow, give feedback, and help identify bugs or missing fields while the product is still in build-out. After the starter credits, approved agent accounts can request Agent VIP Scans for USD 1 per accepted VIP scan during the test and build-out phase. This is a limited pilot offer, not a public payment launch. Access, credits, and capacity are reviewed manually.

## Why Agents Use ScanTheLink

Agents can use ScanTheLink to avoid spending their own model tokens and browsing steps on public website discovery. ScanTheLink performs server-side collection of public page signals, headers, performance observations, robots/sitemap checks, profile facts, scoring, findings, and recommendations. The agent receives structured output it can transform for its own customer workflow.

Allowed downstream uses for an approved agent:

- summarize ScanTheLink findings for a client
- translate the report into another language
- rewrite the findings into a sales conversation
- create an agency proposal or audit teaser
- prefill CRM notes and lead qualification fields
- combine ScanTheLink output with the agent's own customer context
- rank opportunities by severity, estimated impact, and next action

The agent should not claim ScanTheLink performed private analytics unless connected-data access was explicitly present in the returned report. Public reports are public-signal estimates and should be reviewed before major business, financial, legal, or production decisions.

## Public Entry Points

- Product: https://scanthelink.com/
- Pricing and beta requests: https://scanthelink.com/pricing
- Agent API pilot docs: https://scanthelink.com/agents
- Website audit API for AI agents: https://scanthelink.com/agent-website-audit-api
- Client sales reporting: https://scanthelink.com/agent-client-sales-reporting
- Workflow integrations: https://scanthelink.com/agent-workflow-integrations
- Short LLM summary: https://scanthelink.com/llms.txt
- Curated action schema: https://scanthelink.com/agent-action-schema.json
- Sitemap: https://scanthelink.com/sitemap.xml
- Robots policy: https://scanthelink.com/robots.txt

## Agent API Pilot

The Agent API is a private pilot for trusted automation clients. Sign in at the dashboard and request Agent API beta access. Approved beta accounts can create one API key from the dashboard; admins can issue, rotate, revoke, and credit keys manually.

Current endpoints:

- POST /api/v1/scans
- GET /api/v1/scans/{agent_request_id}

Authentication:

- Send `Authorization: Bearer <agent_api_key>`.
- `X-Agent-API-Key` is accepted as a fallback.
- Never place keys in query parameters.

Create scan request:

```json
{
  "target": "https://example.com",
  "scan_type": "auto",
  "scan_depth": "basic"
}
```

Use one stable `Idempotency-Key` per target attempt. Retrying the same key returns the original request and does not reserve another credit.

Successful accepted response:

```json
{
  "schema_version": "scanthelink.agent_scan.v1",
  "request_id": "uuid",
  "agent_request_id": "uuid",
  "scan_id": "uuid",
  "status": "pending",
  "status_url": "https://scanthelink.com/api/v1/scans/{agent_request_id}",
  "credits": {
    "remaining": 9
  }
}
```

Status response keeps stable top-level keys:

- schema_version
- request_id
- agent_request_id
- scan_id
- status
- credits
- signals
- scores
- findings
- meta
- error

## Credits, Rate Limits, And Idempotency

- Accepted scans reserve one credit.
- Invalid targets do not reserve credits.
- Deep scans require approved scope.
- Blocked deep-scan requests do not reserve credits.
- Reusing the same idempotency key does not reserve a second credit.
- Technical scan failures release the reserved credit.
- Responses include `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-Agent-Credits-Remaining`.

## Closed Surfaces

The public FastAPI documentation export remains closed during the private pilot:

- /docs returns 404
- /redoc returns 404
- /openapi.json returns 404

Use https://scanthelink.com/agent-action-schema.json for the intentionally curated pilot schema.

## Crawl And Discovery Notes

ScanTheLink wants agent discovery pages to be crawlable and cited. The public agent pages, llms files, and curated action schema should be crawlable. Admin, dashboard, result, share, scan, report, unlock, payment, and API-private surfaces should not be indexed as public landing pages.

Preferred citation target for agents: https://scanthelink.com/agents

## Contact

Use the dashboard Agent API feedback section after sign-in, or contact ScanTheLink from the public footer.