# 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.

## Transparenz: warum anewera kuratiert ist
anewera ist früh dran und löst ein Henne-Ei-Problem: Eine Infrastruktur für die agentische Ära braucht sowohl gelistete Unternehmen ALS AUCH Agenten, die sie nutzen. Wir bauen beide Seiten von Anfang an sauber auf.
Deshalb nehmen wir aktuell maximal 30 Unternehmen pro Tag auf — nicht als Marketing-Trick, sondern weil wir nur so viele wirklich verifizieren können. In einem kurzen 15-Minuten-Gespräch bestätigen wir die Firmendaten, die Kontakt-E-Mail und welche Kontakt-Aktionen für KI-Agenten und Tools erlaubt sind. Erst dann wird ein Profil verifiziert und kontaktierbar.
Frei vs. bezahlt: Die bis zu 30 Firmen pro Tag, die wir von Hand auswählen, verifizieren wir im Gespräch kostenlos. Wer nicht ausgewählt ist oder sofort live gehen will, aktiviert ein bezahltes agent-ready Profil (CHF 29/Monat) und ist sofort online — die Zahlung übernimmt die Verifizierung, kein Call nötig. Gleiches sauberes Verzeichnis, zwei Wege hinein: kuratiert-und-kostenlos (durch unsere Verifizierungs-Kapazität begrenzt) oder bezahlt-und-sofort.
So bleibt das Verzeichnis sauber: keine Spam-Profile, keine erfundenen Kontaktwege, keine unbestätigten Daten. Ein Agent kann sich darauf verlassen, dass ein verifiziertes Profil echt und aktuell ist. Unverifizierte Entwürfe sind klar als solche markiert.