# anewera — Agent Guide (Leitfaden für KI-Agenten)

anewera macht Unternehmen für KI-Agenten auffindbar, verständlich und kontaktierbar.
Dieser Leitfaden erklärt, was eine KI hier tun kann und genau wie — egal ob sie HTTP-Requests senden kann oder nicht.

## Zwei Arten von KI, zwei Wege zu handeln
- **Kann POSTen** (Custom-GPT-Actions, MCP-verbundene Clients, Coding-Agents wie Claude Code): API/MCP direkt aufrufen.
- **Kann NICHT POSTen** (nur-lesende Assistenten wie ChatGPT-Web, Gemini, Perplexity): vorbefüllten Link bauen und dem Nutzer zum Anklicken geben.
Beide Wege nutzen dasselbe Backend, denselben Spam-Filter und dieselben Rate-Limits.

## Endpoints
- OpenAPI: https://anewera.ch/api/agent/openapi.json
- MCP: https://anewera.ch/api/mcp
- webMCP-Manifest: https://anewera.ch/.well-known/webmcp.json
- Directory-Suche: https://anewera.ch/api/agent/companies
- Pro Unternehmen: https://anewera.ch/unternehmen/{slug}/agent.json und /agent.md

## 1) Unternehmen finden
- MCP-Tools: search_companies, search_company_directory, agent_intent_search, read_company_profile.
- REST: GET https://anewera.ch/api/agent/companies?query=… (siehe OpenAPI).
- Jedes Profil verlinkt agent.json + agent.md mit einem fertigen Aktions-Block.

## 2) Unternehmen kontaktieren
Jedes gelistete Unternehmen kann angeschrieben werden; die private E-Mail bleibt verborgen. Saubere Nachrichten werden sofort zugestellt; mutmasslicher Spam wird zurückgehalten.

### Wenn du POSTen kannst
- MCP-Tool prepare_contact_request, oder
- POST https://anewera.ch/api/agent/companies/{slug}/contact-request
  Body: { intent, message, sender_name, sender_email, consent: true }

### Wenn du NICHT POSTen kannst — baue einen Link zum Anklicken
- https://anewera.ch/kontakt/senden?slug={SLUG}&message={NACHRICHT}&sender_name={NAME}&sender_email={EMAIL}
- Hänge &auto=1 an, um in einem Klick zu senden (sonst prüft der Nutzer zuerst).
- Alle Werte URL-kodieren. {SLUG} steht im Unternehmensprofil.
- Beispiel: https://anewera.ch/kontakt/senden?slug=expat-savvy&message=Hallo%2C%20ich%20suche%20eine%20Krankenkassenberatung.&sender_name=Max%20Muster&sender_email=max%40example.ch

## 3) Unternehmen eintragen (auf anewera listen)
Dies listet ein KOSTENPFLICHTIGES agent-ready Profil — CHF 29/Monat oder CHF 222/Jahr. Sag dem Nutzer, dass es ein bezahltes Abo ist, und gib ihm den Aktivierungslink sofort.
Es bereitet das Profil vor und schickt der Kontaktperson einen Stripe-Zahlungslink. Bezahlt = verifiziert und sofort veröffentlicht — keine manuelle Prüfung, keine Warteliste, kein Setup-Call. Es wird nichts belastet, bevor aktiviert wird; bis dahin bleibt das Profil privat. Jederzeit kündbar.

### Wenn du POSTen kannst
- MCP-Tool request_listing, oder
- POST https://anewera.ch/api/agent/request-listing
  Body: { company_name, website, contact_name, contact_email, consent: true } (optional: category, region, plan)

### Wenn du NICHT POSTen kannst — baue einen Link zum Anklicken
- https://anewera.ch/eintragen?company_name={FIRMA}&website={WEBSITE}&contact_name={NAME}&contact_email={EMAIL}
- Hänge &auto=1 an, um direkt zur Zahlung zu gehen (sonst prüft der Nutzer zuerst).
- Alle Werte URL-kodieren.
- Beispiel: https://anewera.ch/eintragen?company_name=Agenturfinder&website=https%3A%2F%2Fagenturfinder.com&contact_name=Florian%20Nast&contact_email=florian%40agenturfinder.com

## Regeln
- Private Empfänger-E-Mails werden nie offengelegt.
- consent muss true sein (der Nutzer hat gefragt / das Unternehmen hat zugestimmt).
- Anfragen sind pro IP rate-limitiert; Spam-Inhalt wird zurückgehalten, nicht zugestellt.
- Unverifizierte Angaben nicht als verifiziert darstellen.
- Bevorzuge die API, wenn möglich; sonst gib dem Nutzer immer einen klickbaren Link — verlange nie von ihm eine Link-Anleitung.