Korzystanie z DomScan z agentami AI

Korzystanie z DomScan z agentami AI

Połącz DomScan z Claude, ChatGPT, Cursor, VS Code, Codex i Windsurf przez MCP, daj agentom kodującym reguły API, których potrzebują, i zacznij od gotowych promptów.

MCP czy REST API?

Wiele zespołów używa obu: MCP do eksplorowania i prototypowania w czacie lub edytorze oraz REST API w kodzie pisanym przez agenta. Oba korzystają z tego samego klucza API i salda kredytów.

Połącz z narzędziem AI

Konfiguracja według narzędzia

Każde narzędzie łączy się z tym samym serwerem MCP pod adresem https://domscan.net/mcp. Narzędzia obsługujące logowanie otwierają logowanie do DomScan przy pierwszym sprawdzeniu. Pozostałe wysyłają Twój klucz API w nagłówku X-API-Key.

{
  "mcpServers": {
    "domscan": {
      "url": "https://domscan.net/mcp"
    }
  }
}

{
  "servers": {
    "domscan": {
      "type": "http",
      "url": "https://domscan.net/mcp"
    }
  }
}

[mcp_servers.domscan]
url = "https://domscan.net/mcp"
env_http_headers = { "X-API-Key" = "DOMSCAN_API_KEY" }

{
  "mcpServers": {
    "domscan": {
      "serverUrl": "https://domscan.net/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Te linki i polecenia nigdy nie zawierają Twojego klucza API. Narzędzia obsługujące logowanie łączą się bezpośrednio z Twoim kontem DomScan. Aby zamiast tego użyć klucza, zastąp YOUR_API_KEY kluczem z sekcji Twoje klucze API.

Instrukcje dla agentów kodujących

Wklej to do AGENTS.md, CLAUDE.md lub pliku reguł swojego edytora, aby agenci kodujący poprawnie wywoływali DomScan.

## DomScan API

Używaj DomScan (https://domscan.net) do sprawdzania dostępności domen, DNS, WHOIS i RDAP, SSL, bezpieczeństwa poczty e-mail oraz wyceny.

- Bazowy URL: `https://domscan.net`. Endpointy znajdują się pod `/v1`.
- Uwierzytelnianie: wysyłaj `X-API-Key: $DOMSCAN_API_KEY` (lub `Authorization: Bearer $DOMSCAN_API_KEY`). Odczytuj klucz ze zmiennej środowiskowej. Nigdy nie wpisuj go na stałe w kodzie, nie loguj go i nie umieszczaj w URL.
- Kontrakt: przed wyborem endpointu lub parametru przeczytaj opis OpenAPI pod adresem https://domscan.net/v1/openapi.json i nie zgaduj nazw parametrów. Streszczenie witryny dla LLM znajduje się pod adresem https://domscan.net/llms.txt.
- MCP: zdalny serwer to https://domscan.net/mcp (streamable HTTP, logowanie lub te same nagłówki z kluczem API).
- Kredyty: większość endpointów kosztuje kredyty. Przed pracą masową lub powtarzalną wywołaj `POST /v1/estimate` z polami `method`, `path`, `query` i `body` żądania albo dodaj `dry_run=true` do endpointów masowych, porównań, recipe i cen. Oba rozwiązania są bezpłatne. Śledź nagłówki odpowiedzi `X-Credits-Charged` i `X-Credits-Remaining`.
- Masowo: sprawdzaj do 50 pełnych nazw domen jednym żądaniem `POST /v1/status/bulk` zamiast wywoływać pojedyncze sprawdzenia w pętli.
- Ponowienia: wysyłaj nagłówek `Idempotency-Key` (na przykład UUID) w żądaniach POST, które pobierają kredyty. Ponowienie tego samego żądania z tym samym kluczem w ciągu 24 godzin zwraca zapisaną odpowiedź bez ponownego naliczenia opłaty. Ponawiaj tylko wtedy, gdy `error.retryable` ma wartość true, a przy 429 poczekaj zgodnie z `Retry-After`.
- Błędy: każde ciało błędu ma postać `{"error": {"type", "code", "message", "status", "retryable", "request_id", ...}}`. Rozgałęziaj logikę według `error.code`, na przykład `INVALID_PARAMETER`, `INSUFFICIENT_CREDITS` lub `RATE_LIMITED`, a nie według komunikatu.
- Nieznane nie znaczy nieobecne: wyniki zawierają `classification.status` o wartości `present`, `absent` lub `unknown`. Traktuj `unknown` jako "spróbuj ponownie później", nigdy jako dostępne ani brakujące, i nigdy nie traktuj braku jako dowodu, że nazwę można zarejestrować lub zająć.
- Aktualność: endpointy, które mogą odpowiadać na podstawie świeżych danych, przyjmują `max_age` w sekundach (`max_age=0` żąda nowego sprawdzenia) i zwracają `cache_age_s`. Nie zmienia to kosztu.
- Mniejsze odpowiedzi: dodaj `fields=a,b.c` lub `compact=true` do query stringa. Żadne z nich nie zmienia kosztu.
- Więcej: https://domscan.net/AGENTS.md i https://domscan.net/docs.

Prompty do wypróbowania

Skopiuj prompt lub otwórz go w swoim asystencie. Najpierw połącz DomScan, aby asystent mógł uruchamiać sprawdzenia.

1. Użyj DomScan, aby sprawdzić, czy te 50 nazw jest dostępnych jako domeny .com: [wklej nazwy]. Najpierw oszacuj koszt w kredytach i pokaż mi go, zanim cokolwiek uruchomisz. Następnie wypisz osobno wyniki dostępne, zajęte i nieznane i nie traktuj nieznanych wyników jako dostępnych.

   Otwórz w ClaudeOtwórz w ChatGPTOtwórz w Cursor

2. Użyj DomScan, aby sprawdzić bezpieczeństwo poczty e-mail dla example.com: SPF, DKIM, DMARC i status na czarnych listach. Wyjaśnij każdy problem prostym językiem i zaproponuj rekord DNS, który go naprawi.

   Otwórz w ClaudeOtwórz w ChatGPTOtwórz w Cursor

3. Rozważam kupno example.com. Użyj DomScan, aby sprawdzić jego WHOIS i daty rejestracji, DNS, certyfikat SSL, reputację i szacowaną wartość, a następnie podsumuj ryzyka i to, co powinienem zweryfikować przed zapłatą.

   Otwórz w ClaudeOtwórz w ChatGPTOtwórz w Cursor

4. Użyj DomScan, aby znaleźć już zarejestrowane domeny podobne do example.com oraz domeny typosquattingowe. Uszereguj je według ryzyka i wskaż te, które mają stronę internetową lub serwer pocztowy.

   Otwórz w ClaudeOtwórz w ChatGPTOtwórz w Cursor

5. Dodaj DomScan do tego projektu. Przeczytaj https://domscan.net/AGENTS.md i https://domscan.net/v1/openapi.json, a następnie napisz mały typowany klient dla POST /v1/status/bulk, który odczytuje DOMSCAN_API_KEY ze środowiska, wysyła nagłówek Idempotency-Key i oddziela nieznane wyniki od dostępnych. Dodaj testy.

   Otwórz w ClaudeOtwórz w ChatGPTOtwórz w Cursor

Zasoby czytelne maszynowo

Kieruj agentów do tych publicznych plików zamiast kopiować dokumentację do promptów.

• /AGENTS.md Publiczny przewodnik dla agentów
• /llms.txt Streszczenie witryny dla LLM
• /v1/openapi.json OpenAPI 3.0
• /mcp/tool-mapping.json Stare i nowe nazwy narzędzi MCP