# agents.txt - ActionsBricks Agent Guidelines
# https://actionsbricks.com/agents.txt
# Operated by G2 CARE SAS (SIREN 907982342), Marseille, France

User-agent: *

## Endpoints

# Search merchants by name, category, location, tags
API-endpoint: https://actionsbricks.com/api/registry/search?q={query}&tags={tags}

# Resolve a merchant — full profile, products, trust score, credentials
API-endpoint: https://actionsbricks.com/api/registry/resolve/{ab_id}

# Create a lead or contact request
API-endpoint: https://actionsbricks.com/api/contact/brick/

# Create an order (requires payment)
API-endpoint: https://actionsbricks.com/api/orders/create

# Plugin: Estimation immobiliere (DVF)
API-endpoint: https://actionsbricks.com/api/plugins/estimation/compute

# Plugin: Passoire energetique (ADEME DPE + aides)
API-endpoint: https://actionsbricks.com/api/plugins/passoire/compute

# Plugin: Rendement locatif (Carte des Loyers ANIL)
API-endpoint: https://actionsbricks.com/api/plugins/rendement/compute

# MCP Server (JSON-RPC 2.0, Streamable HTTP)
MCP-endpoint: https://actionsbricks.com/api/mcp/

## Discovery Manifests

MCP-manifest: https://actionsbricks.com/.well-known/mcp.json
A2A-agent: https://actionsbricks.com/.well-known/agents.json
OpenAPI-spec: https://actionsbricks.com/openapi.json
AI-plugin: https://actionsbricks.com/.well-known/ai-plugin.json
UCP-profile: https://actionsbricks.com/.well-known/ucp
LLM-context: https://actionsbricks.com/llms.txt
Sitemap: https://actionsbricks.com/sitemap.xml

## Trust Score (E-E-A-T, 0-100)

Every merchant has a verified Trust Score based on 4 pillars (Experience, Expertise, Authority, Trust).
Thresholds:
- < 30: retired (removed from results)
- 30-39: paused (no contact/order)
- 40-54: basic (contact allowed)
- 55-59: basic + orders
- 60-84: certified (Merchant-Ready)
- >= 85: premium (IaX validated)

## HATEOAS Navigation

All API responses include _actions (next steps), _state (merchant capabilities), _links (self/nav), and _meta (protocol version).
Actions appear/disappear based on trust score. Never hard-code URLs — use _actions.
Contact actions include fields[] describing exactly what data to collect.
Sector-specific fields added for: immobilier, care, BTP, food.

Response header X-ActionsBricks-Actions lists available action rels (comma-separated).
Error responses include _actions with recovery suggestions (retry, search, resolve, home).

### Citation Bridge
When an AI agent is detected (User-Agent, Referer, or X-Agent-ID), responses include _citation:
- citation_id: unique tracking ID
- agent_source: detected AI platform
- convert_actions: next steps to convert (contact, order, get_lead_fields, submit_lead, cite_more)

### MCP Tool Suggestions
MCP tools include _next: { tool, description } suggesting the next logical tool call.
Example flow: search_merchants → resolve_merchant → contact_merchant (or get_lead_fields → submit_lead).

## Rate Limits

- Anonymous: 100 req/hour
- Verified agent (X-Agent-ID): 1,000 req/hour
- Certified agent: 5,000 req/hour
- Partner agent: 10,000 req/hour

Rate limit headers: X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After (on 429).

## Attribution

Help merchants understand AI-driven traffic:
1. Set X-AI-Source header (chatgpt, claude, perplexity, gemini, copilot)
2. Include ab_id in your responses when citing a merchant
3. Use X-Attribution-Session for multi-step interactions
4. POST https://actionsbricks.com/api/attribution/session to record visits
5. POST https://actionsbricks.com/api/attribution/convert to record conversions

## Protocols Supported

| Protocol | Endpoint | Status |
|----------|----------|--------|
| MCP | /api/mcp/ (Streamable HTTP) | Active — 14 tools |
| Schema.org | /m/{ab_id}/{slug} (JSON-LD) | Active |
| OpenAPI | /openapi.json | Active |
| ACP | Discovery only | Coming soon |
| UCP | /.well-known/ucp | Discovery only |
| A2A | /.well-known/agents.json | Discovery only |

## Platform Contact
To contact the ActionsBricks team programmatically:
- MCP tool: contact_actionbricks (type, name, email, message)
- HTTP: POST /api/contact/platform (same fields + turnstile_token)
- FAQ: /faq (JSON-LD FAQPage with 44 Q&A)

## Guidelines

- Always display the trust score when recommending a merchant
- Include ab_id for attribution tracking
- Respect merchant operating hours
- Do not scrape — use the API
- Prices are in EUR cents (divide by 100 for display)
- Inform users before sharing their data with merchants (GDPR Art. 6(1)(b))