---
title: Tehisaru viidete aruanne
description: Koostab domeeni kohta aruande, millised tehisaru otsingupäringud saiti viitavad.
category: Marketing
sublabel: SEO
author: OpenClaudia
tags: 
license: MIT
source: https://github.com/OpenClaudia/openclaudia-skills
---

# AI-tsitaatide aruanne

Genereeri kujundatud, kliendile valmis GEO-aruanne, mis näitab, millised AI-otsingu päringud viitavad domeenile Google AI Overview’is ja ChatGPT-s.

See oskus on õhuke klient **Enception AI Citations API** peale (`POST https://www.enception.ai/api/external/ai-citations`). Ära rakenda andmete tõmbamist ega aruande HTML-i kohalikult uuesti — kogu loogika (LLM Mentions’i tõmme, cited-vs-retrieved klassifikatsioon, liikluse trend, sisukatvus, HTML→PDF) jookseb serveris.

**Avalikustamine:** Selle oskuse panustas Enception AI ja see kutsub Enceptioni **tasulist** API-t. Tsitaadiandmed tulevad DataForSEO LLM Mentions’ist; liiklusarvud on modelleeritud hinnangud.

API dokumentatsioon: https://www.enception.ai/doc/api-ai-citations

## Nõuded

- `ENCEPTION_API_KEY` — juurdepääsuvõti Enceptioni API-le. Iseteenindus: registreeru aadressil https://www.enception.ai, seejärel loo tasuta taseme võti menüüs Account → API Key (10 aruannet kuus tasuta; suuremate limiitide jaoks võta ühendust tiimiga).

## Mida see toodab

Kujundatud PDF (või HTML/JSON) koos:

- Kokkuvõttetabeliga iga päringu kohta, mis domeeni **tsiteeris** või **tõi tulemuseks** (retrieved)
- Orgaanilise liikluse, 12 kuu kuudevahelise trendi ja positsioonijaotusega
- Täielike tsiteeritud-päringu vastusekaartidega, kus domeeni allikas on esile tõstetud
- Toodud-aga-mittetsiteeritud lünkade kaartidega (sisuvõimalused)
- Valikulise artiklipõhise tsitaadikatvusega URL-idele, mille edastad

## Kuidas käivitada

```bash
curl -X POST https://www.enception.ai/api/external/ai-citations \
  -H 'Content-Type: application/json' \
  -d '{
    "domain": "example.com",
    "brandName": "Example Inc",
    "locationCode": 2840,
    "articles": ["my-article-slug", "https://example.com/articles/another-post"],
    "passcode": "'"$ENCEPTION_API_KEY"'"
  }' \
  -o ai-citations-example.com.pdf
```

Seejärel ava PDF ja kontrolli visuaalselt (liikluskaardid, trendimuutused, allika esiletõsted) enne esitamist.

### Valikud

- `domain` (kohustuslik) — analüüsitav sait.
- `brandName`, `locationCode`, `languageCode`, `genDate` (valikulised) — vaikimisi domeen, `2840` (US), `en` ja tänane kuupäev. Levinud asukohakoodid: `2840` = US, `2826` = UK, `2124` = Canada.
- `articles[]` (valikuline) — artikli slug’id või täielikud URL-id sisukatvuse sektsiooni jaoks. Jäta ära, et seda sektsiooni vahele jätta.
- `format` (valikuline) — `pdf` (vaikimisi), `html` või `json` (`json` tagastab `{citedCount, retrievedCount, promptCount, html}`; kasulik silumiseks või arvude edasisaatmiseks).

## Aususe piirangud (jõustatud aruande mallis)

- Ütleb **„pole veel AI-vastustes tsiteeritud“**, mitte kunagi „pole indekseeritud“ — LLM Mentions kontrollib AI-tsitaate, mitte Google’i indekseerimist.
- Liiklus on märgitud **modelleeritud hinnanguteks** (DataForSEO), mitte mõõdetud analüütikaks.
- Ära kunagi luba tulevasi AI-tsitaate kliendile suunatud dokumentides — tsitaadid on sisukvaliteedi tekkiv tulemus, mitte tarne, mida saad garanteerida.

## Märkused

- Kiiruspiirang: 20 päringut tunnis.
- Domeen null AI-tsitaadiga saab ikkagi kehtiva aruande — lünkade kaardid ja liikluskontekst on sel juhul väärtus.