---
title: GEO-analüüs
description: Teeb domeeni kohta tervikliku GEO/SEO kliendianalüüsi.
category: Marketing
sublabel: SEO
author: OpenClaudia
tags: 
license: MIT
source: https://github.com/OpenClaudia/openclaudia-skills
---

# GEO-analüüs

Käivita domeeni täielik GEO/SEO-analüüs ja saa kliendile valmis PDF-aruanne: AI-nähtavus (kas brändi soovitavad ChatGPT / Google AI), sügav turu-uuring ja konkurentsimaastik.

Õhuke ümbris Enceptioni kliendianalüüsi API ümber. Kolm toimingut: **start**, **status**, **report** (pluss valikuline brändinime korrigeerimine).

**Avalikustamine:** panustanud Enception AI ja kutsub Enceptioni **tasulist** välist API-d. Dokumentatsioon: https://www.enception.ai/doc/api-client-analysis

## Nõuded

- `ENCEPTION_ANALYSIS_API_KEY` — saadetakse päisena `x-api-key`. Ise teenindus: registreeru aadressil https://www.enception.ai, seejärel loo tasuta taseme võti jaotises Account → API Key (2 analüüsi kuus tasuta; suuremate limiitide jaoks võta ühendust meeskonnaga). Kiirusepiirang: 10 päringut minutis.

## 1. Start

`POST https://www.enception.ai/api/external/client-analysis/start`

Kohustuslik: `website_url`, `primary_region`, `core_goals`. Mõistlikud vaikeväärtused: `primary_region=us`, `core_goals=traffic`, `output_language=en`, `competitors=[]`. API normaliseerib URL-id tavaliseks domeeniks ja lükkab IP-d tagasi. Tagastab `{ id, message }` — **salvesta `id`**.

Vali `output_language` kõigepealt selgesõnalisest soovist, seejärel kasutaja vestluskeelest, seejärel domeeni TLD-st (`.cn` → `zh`; muul juhul `en`).

```bash
curl -s -X POST "https://www.enception.ai/api/external/client-analysis/start" \
  -H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
  -d '{"website_url":"https://example.com/","primary_region":"us","competitors":[],"core_goals":"traffic","output_language":"en"}'
```

Muuda `primary_region` / `core_goals` / `competitors` ainult siis, kui kasutaja seda täpsustab. `core_goals` on vaba tekst (nt `traffic`, `ranking`). Konkurendid: `[{"name":"X","domain":"x.com"}, ...]` (max 5). Mitme domeeni korral tee igaühele üks POST ja kogu id-d kokku.

## 2. Status

`POST https://www.enception.ai/api/external/client-analysis/status` kehaga `{ "id": "<id>" }` ja sama `x-api-key` päisega. Tagastab `{ status: 'pending' | 'failed' | 'succeeded', progress_percent?, pdf_url? }`.

Täielik jooks võtab **~20–45 minutit** — pudelikael on sügava turu-uuringu samm. Küsi staatust pika intervalliga (minutites, mitte sekundites). `succeeded` ⇒ aruanne on valmis allalaadimiseks. Kui jooks ebaõnnestub või jääb lõputult seisma, teata sellest kasutajale, ära leiuta tulemusi.

## 3. Report

`GET https://www.enception.ai/api/external/client-analysis/report/<id>` — avalik, autentimist ei vaja; jagatav id järgi. Töötab, kui staatus on `succeeded` (serveerib ka osalisi jookse).

```bash
curl -s -o geo-analysis-example.pdf \
  "https://www.enception.ai/api/external/client-analysis/report/<id>"
```

Kinnita, et tegu on päris PDF-iga (`file geo-analysis-example.pdf`), seejärel anna kasutajale fail ja/või avalik URL.

## 4. Paranda „nullnähtavus“ (brändinime korrigeerimine)

`POST https://www.enception.ai/api/external/client-analysis/update-brand` kehaga `{ "id", "brand_name"?, "alternative_names": [...] }` ja `x-api-key` päisega.

Kui aruanne näitab null- või madalat AI-nähtavust, aga brändi SIISKI soovitavad ChatGPT/Google, on peaaegu alati põhjuseks see, et bränd on tuntud ainult kokkusulatatud domeenisildina (nt `pudurobotics`), samas kui AI-mootorid ütlevad „Pudu Robotics“. Anna päris nimi + aliased ja marsruut arvutab nähtavuse juba salvestatud vastustest uuesti (uut päringut ei tehta — kiire), seejärel laadi aruanne uuesti.

```bash
curl -s -X POST "https://www.enception.ai/api/external/client-analysis/update-brand" \
  -H "x-api-key: $ENCEPTION_ANALYSIS_API_KEY" -H "Content-Type: application/json" \
  -d '{"id":"<id>","brand_name":"Pudu Robotics","alternative_names":["Pudu","PuduBot"]}'
```

Tagastab `{ success, mention_rate, overall_score, average_position, analysis_regenerated }`. Uued analüüsid lahendavad brändinime automaatselt; see on olemasolevate aruannete käsitsi korrigeerimise tee.