nordabiz/docs/SEO-AUDIT-API-RESEARCH-2026.md

273 lines
11 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Badania API dla Audytu SEO — Raport 2026
**Data:** 2026-02-08
**Zakres:** Bing Webmaster Tools API, Brave Search API, IndexNow API
**Cel:** Ocena możliwości integracji dla platformy NordaBiz (150 firm)
---
## 1. BING WEBMASTER TOOLS API
### Czy API istnieje?
**TAK.** API oficjalnie wspierane przez Microsoft, dostępne via Microsoft Learn.
### Dostępne Endpointy
| Endpoint | Funkcja | Notatka |
|----------|---------|---------|
| `GetUrlSubmissionQuota` | Sprawdzenie pozostałego limitu zgłoszeń | Limity dzienne/miesięczne |
| **URL Submission (Single)** | Zgłoszenie pojedynczego URL | Indeksowanie natychmiastowe |
| **URL Submission (Batch)** | Zgłoszenie wielu URL jednocześnie | API URL submission (preferowane) |
| **Sitemaps Management** | Zgłoszenie/zarządzanie mapami witryny | — |
| **Rank & Traffic Stats** | Dane o rankingach i ruchu | Historyczne dane wydajności |
| **Link Details** | Analiza linków wychodzących | Backlinki do domeny |
| **Keyword Details** | Dane o słowach kluczowych | Wyniki dla queryów |
| **Crawl Stats** | Statystyki crawlowania przez Binga | HTTP status, blokady, indeksowanie (6 mies. historii) |
**Endpoint URL:** `https://ssl.bing.com/webmaster/api.svc/json/{METHOD_NAME}?apikey={API_KEY}`
### Autentykacja
| Typ | Szczegóły | Bezpieczeństwo |
|-----|-----------|----------------|
| **API Key** | Generowany per user w Bing Webmaster Tools → Settings → API Access | Prosty, ale jedna klucz dla wszystkich serwisów |
| **OAuth 2.0** | Rekomendowany, token dostępu generowany z Bing Webmaster Tools | Bezpieczniejszy, standard nowoczesny |
⚠️ **Ważne:** Jeśli klucz zostanie skompromitowany, musi być usunięty i wygenerowany nowy (wszystkie aplikacje tracą dostęp).
### Dane dostępne
- ✅ Zapytania wyszukiwania (search queries)
- ✅ Dane crawlowania (crawl statistics)
- ✅ Raporty wydajności SEO (rank & traffic)
- ✅ Zgłoszenia URL (URL submission)
- ⚠️ **Brak:** Realtime ranking position, detailed competitor analysis
### Limity i koszt
| Parametr | Wartość |
|----------|---------|
| **Rate Limit** | Zależy od planu (konkretne wartości w dokumentacji Azure) |
| **Limit URL dziennie** | Zależy od potwierdzenia domeny i historii |
| **Koszt** | **Bezpłatny** (wbudowany w Bing Webmaster Tools) |
| **Ogół limit** | HTTP 429 przy przekroczeniu |
### Czy jest istotny dla polskiego rynku?
⚠️ **OGRANICZONA ISTOTNOŚĆ**
| Metryka | Wartość | Wniosek |
|---------|---------|---------|
| Udział Binga w Polsce | ~3-4% (szacunek) | Znacznie poniżej 50% Google |
| Europejski kontekst | 3.95% (Europa), 90.25% (Google) | Drugorzędny kanał |
| Siła demograficzna | Wyższy purchasing power niż u Google | Wartościowi użytkownicy, ale mało |
| Yahoo (powered by Bing) | Marginalny w Polsce | Prawie żaden impact |
**Rekomendacja:** Dla 150 firm w Polsce — **NISKA ISTOTNOŚĆ**. Bardziej wartościowy dla anglojęzycznych rynków (USA, UK) lub ekspansji międzynarodowej.
### Złożoność implementacji dla 150 firm
| Aspekt | Poziom | Notatka |
|--------|--------|---------|
| Integracja techniczna | **Łatwy** | REST API, obsługuje Python, cURL |
| Onboarding firm | **Średni** | Każda firma musi mieć Bing Webmaster Tools + wygenerować API key |
| Zarządzanie kluczami | **Średni** | Jeden klucz per user (zarządzanie 150 userów) |
| Obsługa błędów | **Łatwy** | REST + JSON, standard |
| **Średni czas integracji na firmę** | **20-30 min** | Setup Bing + API key generation |
**Infrastruktura:** `O(150)` czasu onboardingu per firma, jedna integracja API. Dobrze skaluje się dla batch operations (Batch URL Submission).
---
## 2. BRAVE SEARCH API
### Obecne możliwości
Brave Search API zapewnia dostęp do **niezależnego indeksu WWW** (30+ miliardów stron, aktualizowanych codziennie).
| Możliwość | Status | Szczegóły |
|-----------|--------|-----------|
| **Web Search** | ✅ | 30B+ stron, 100M+ aktualizacji dziennie |
| **Citation Checking** | ✅ | AI-synthesized answers z cytatami (inline references) |
| **SERP Results** | ✅ | Tytuły, URL, opisy, snippety |
| **Local Search** | ✅ | Dedicated endpoint |
| **Images** | ✅ | Dedicated endpoint |
| **News** | ✅ | Dedicated endpoint |
| **Rankings Position** | ❌ | Brak — tylko search results |
| **Rank History** | ❌ | Brak |
| **Backlinks** | ❌ | Brak |
### Autentykacja
**Typ:** API Key via `X-Subscription-Token` header
**Metoda:** Token-based (POST/GET requests)
**Bezpieczeństwo:** Standard
```bash
curl -X GET "https://api.search.brave.com/res/v1/web/search?q=query" \
-H "X-Subscription-Token: YOUR_TOKEN"
```
### Limity i ceny
| Plan | Koszt | Rate Limit | Zapytań/miesiąc | Użytek |
|------|-------|-----------|-----------------|--------|
| **Free** | $0 | 1 req/s | 2,000 | Testowanie |
| **Base** | $3 per 1K | 20 req/s | 20M | SMB |
| **Pro** | $5 per 1K | 50 req/s | Unlimited | Enterprise |
| **Enterprise** | Custom | Custom | Custom | Custom |
**CPM (Cost Per Mille):** $3-5 na 1000 zapytań (tańszy niż Google's $5 CPM)
**Wydajność:** 95% zapytań < 1 sekunda (Brave obsługuje 50M+ wyszukiwań dziennie)
### Dane SEO-relevantne
**Możliwe do ekstrakcji:**
- SERP results (pozycje, snippety)
- Citation checking (dla fact-checking)
- AI-synthesized summaries (aggregate answers)
- Rerank feature (custom domain boosting/removal)
**Niemożliwe:**
- Current ranking position dla konkretnej domeny
- Historical trend data
- Backlink analysis
- Keyword difficulty scores
### Zastosowania
| Przypadek | Wykonalne? | Rekomendacja |
|-----------|-----------|--------------|
| Citation Checking | **TAK** | Brave jest doskonały NordaBiz już go używa |
| Competitor Analysis (snapshot) | **TAK** | Możliwe dla pojedynczych queryów (SERP snapshots) |
| SERP Feature Detection | **TAK** | Analiza wyników dla local pack, featured snippets, itp. |
| Real-time Rankings | | Nie brak históry pozycji |
| Keyword Tracking | | Nie brak Tracking API |
### Porównanie z Google Custom Search API
| Wymiar | Brave | Google |
|--------|-------|--------|
| **Niezależny indeks** | Własny 30B+ | Własny index, ale ograniczone API |
| **Cena** | $3-5 CPM | $5+ CPM |
| **Dostępność** | Open, Free tier istnieje | Ograniczone, wymaga kontaktu handlowego |
| **Jakość spam-filtering** | Wyraźnie zoptymalizowany | Świetny (ale droższy) |
| **SERP-specific data** | Full results | Full results |
| **Ranking position API** | | |
| **Privacy** | Brak trackingu | Analytics tracking |
**Wniosek:** Brave jest **lepszą alternatywą** dla SEO audytów opartych na SERP snapshots. Google Custom Search jest bardziej dla custom search experience niż SEO data.
---
## 3. INDEXNOW API
### Co to jest IndexNow?
**Definicja:** Protokół notyfikacyjny umożliwiający właścicielom stron natychmiastowe powiadomienie wyszukiwarek o zmianach treści (dodane, zaktualizowane, usunięte URL).
**Mechanizm:** Prosty ping do wyszukiwarek priorytetowe crawlowanie zmienionego URL (zamiast czekać na autodiscovery).
**Format:** REST API + XML sitemap extensions
### Jak działa?
```
1. Właściciel strony → IndexNow API
2. Wysyła: { "urlList": ["url1", "url2"], "keyLocation": "url" }
3. Wyszukiwarka → Natychmiast crawluje URL
4. Efekt: Indeksacja w minuty (zamiast dni/tygodni)
```
### Które wyszukiwarki wspierają IndexNow?
**Wspierające (2026):**
- **Bing** (Microsoft) pełna obsługa
- **Yahoo** (powered by Bing) pośrednia
- **Yandex** (rosyjski) pełna obsługa (znaczący w Europie Wschodniej)
- **Seznam.cz** (czeski) pełna obsługa
- **Naver** (koreański) pełna obsługa
- **Yep** (nowy, independentny index) pełna obsługa
**Nie wspierające:**
- **Google** Utrzymuje własne Indexing API (bardziej restrykcyjne, dla verified partnerships)
### Czy IndexNow jest dla audytu SEO?
**NIE — głównie dla URL submission, ale ma elementy audytu.**
| Funkcja | Dostępna? | Notatka |
|---------|-----------|---------|
| **URL Submission** | **TAK** | Główne zastosowanie |
| **SEO Audit** | **Częściowo** | IndexNow dashboard ma "SEO audit, technical audit" |
| **Indexed Pages Report** | | Report indeksowanych stron (w Google Search Console) |
| **Crawl Data** | | Brak IndexNow to submission-only |
| **Search Queries** | | Brak to praca dla Bing Webmaster Tools |
**Główny cel:** Przyspieszenie indeksacji, nie analiza SEO.
### Integracja z NordaBiz — czy warte?
| Aspekt | Ocena | Wniosek |
|--------|-------|---------|
| Potrzeba dla 150 firm | ⭐⭐⭐ | Tak jeśli firmy często publikują treści |
| Implementacja | ⭐⭐⭐⭐ | Bardzo łatwa (REST API) |
| Wpływ na SEO | ⭐⭐ | Przyspieszenie indeksacji, nie ranking |
| Koszt | Bezpłatny | |
| Obsługa multilingual | | Wspiera wszystkie języki |
**Rekomendacja:** Wdrożyć IndexNow **na stronie NordaBiz głównej** (dla nowych firm, profili). Dla audytu SEO firm **drugorzędne znaczenie** (to URL submission, nie analytics).
---
## PODSUMOWANIE I REKOMENDACJE
### Dla audytu SEO NordaBiz (150 firm)
| API | Prioritet | Uzasadnienie |
|-----|-----------|--------------|
| **Brave Search API** | 🔴 **WYSOKIE** | Już wdrażany, doskonały dla citation checking + SERP snapshots |
| **Bing Webmaster Tools API** | 🟡 **ŚREDNIE** | Limity rynku (3-4% Poland), ale użyteczny dla międzynarodowej ekspansji |
| **IndexNow API** | 🟡 **ŚREDNIE** | Przydatne dla szybkiego indexowania, ale nie dla analityki SEO |
### Strategia implementacji (Phase 1-2)
**Phase 1 (Q1 2026) — BRAVE SEARCH:**
- Rozszerzyć obecne citation checking
- Dodać SERP snapshot tracking dla wybranych konkurentów (5-10 firm)
- Zbudować "SERP Feature Detection" (local pack, featured snippets)
**Phase 2 (Q2 2026) — INDEXNOW + BING (opcjonalnie):**
- Wdrożyć IndexNow na stronie głównej NordaBiz
- Bing Webmaster API tylko jeśli firmy chcą międzynarodowego reach (de, uk, belarusia)
### Złożoność implementacji
| API | Time-to-market | Infrastruktura | Uwagi |
|-----|----------------|-----------------|-------|
| Brave | 1-2 tygodnie | Minimize (już setup) | Rozszerzyć istniejące |
| IndexNow | 3-5 dni | Minimal (REST API) | Plugin/library dostępne |
| Bing | 2-3 tygodnie | Moderate (OAuth/key mgmt) | Per-firma onboarding |
---
## REFERENCJE
- [Bing Webmaster Tools API - Microsoft Learn](https://learn.microsoft.com/en-us/bingwebmaster/)
- [Bing Webmaster API Getting Access](https://learn.microsoft.com/en-us/bingwebmaster/getting-access)
- [Brave Search API Official](https://brave.com/search/api/)
- [Brave Search API vs Google Comparison](https://brave.com/search/api/guides/what-sets-brave-search-api-apart/)
- [IndexNow Official Documentation](https://indexnow.org/)
- [IndexNow Search Engines Support](https://indexnow.org/searchengines)
- [Bing Market Share Poland 2025](https://gs.statcounter.com/search-engine-market-share/all/poland)
- [Bing Webmaster URL Submission API](https://www.bing.com/webmasters/url-submission-api)
- [Best SERP APIs 2026 - Scrapfly](https://scrapfly.io/blog/posts/google-serp-api-and-alternatives)
- [Brave Search API Pricing and Rates](https://api-dashboard.search.brave.com/app/documentation/web-search/responses)
---
**Status dokumentu:** Draft
**Autor:** Claude Code
**Zaktualizowano:** 2026-02-08