See how ChatGPT, Claude, Gemini, Perplexity & friends talk about your brand — then out-publish your competitors with an AI writing studio built right in.
Quick start · Features · Configuration · Architecture · Roadmap
Search moved into the chat box. People ask ChatGPT and Perplexity for recommendations instead of scrolling ten blue links. AEO — Answer Engine Optimization — is the new SEO, and Ideata is the open, self-hosted way to measure it and win it.
- Track your AI visibility. Run your real buyer prompts across 8+ engines and see exactly when you're mentioned, cited, or ignored — and who gets recommended instead of you.
- Benchmark competitors. Share of voice, sentiment, and which sources the models actually trust.
- Close the gap. A built-in AI writing studio that researches, drafts, and multi-posts content engineered to get cited back.
- Own everything. Runs entirely on your infrastructure. Bring your own API keys. No seats, no per-report fees, no limits.
- 8+ answer engines — ChatGPT, Claude, Gemini, Perplexity, DeepSeek, Grok + regional Yandex (Alice / Neuro) & GigaChat
- Prompt panels — track dozens of real prompts, run on a daily schedule
- Mentions & citations — read the exact AI answers that name you
- Competitor analysis — share of voice, sentiment, source leaderboard
- AI-crawler analytics — GPTBot, ClaudeBot & co. via Cloudflare
- AI-referred traffic — Yandex Metrica + Google Search Console
- Full pipeline — brief → research → outline → draft → anti-slop → fact-check
- Per-article model with a live price estimate before you spend a token
- Brand-voice agent — one prompt, quality gates, target length & sources
- Cover studio — 12 built-in templates, PNG composited in the browser
- Content calendar + idea generator
- Bilingual — interface and generated content in English or Russian
One article, rewritten per platform — each with its own character limit, threading rules, tone and hashtag policy, not the same text copy-pasted everywhere.
- One-click publish — Telegram, X, LinkedIn, Bluesky, Mastodon
- Auto-pull — Zen subscribes to your
rss.xmland picks articles up itself - Adapt & copy — VK, Threads
- The article itself — your own blog, WordPress (app password or OAuth), or any REST endpoint
- Media included: images and video ride along to every connector that accepts them
- One
docker compose upbrings up Postgres, Redis, the API, the worker and the dashboard. - Bring your own keys through a slick in-app Settings UI — one OpenRouter key for everything, or native per-provider keys for geo-control.
- Bilingual dashboard — English / Русский, switchable in a click.
- No phone-home. Everything runs on your machine.
git clone https://github.com/Dallowin/ideata.git
cd ideata
cp .env.example .env # add at least one LLM key (e.g. OPENROUTER_API_KEY)
docker compose up -d --buildThen open http://localhost:8080, sign up (the first account becomes the owner/admin), go to Settings → Providers, paste your keys, and run your first analysis.
No cloud account. No credit card. Just Docker.
Everything is configured through .env (see .env.example) or, once
you're the owner, straight from the dashboard. The only thing you truly need is model access —
and there are two ways to give it.
Engines are split across providers. Set the keys for the engines you actually want:
| Engine | Variable | Where |
|---|---|---|
| ChatGPT, Claude, Gemini, DeepSeek, Grok, Perplexity | OPENROUTER_API_KEY |
openrouter.ai/keys |
| ChatGPT — official OpenAI API | OPENAI_API_KEY |
platform.openai.com |
| Claude — official Anthropic API | ANTHROPIC_API_KEY |
console.anthropic.com |
| Gemini — official Google API + all image generation | GEMINI_API_KEY |
aistudio.google.com |
| DeepSeek — official DeepSeek API | DEEPSEEK_API_KEY |
platform.deepseek.com |
| Grok — official xAI API | XAI_API_KEY |
console.x.ai |
| Perplexity — official Sonar API | PERPLEXITY_API_KEY |
perplexity.ai/settings/api |
| Google AI Overviews | DATAFORSEO_LOGIN / DATAFORSEO_PASSWORD |
dataforseo.com |
| GigaChat (RU market) | GIGACHAT_API_KEY |
developers.sber.ru/studio |
| Yandex Alice, Yandex Neuro (RU market) | YANDEX_SEARCH_API_KEY + YANDEX_CLOUD_FOLDER_ID |
console.yandex.cloud |
One key is enough — the rest is per engine. With just
OPENROUTER_API_KEYall six global engines run. Each engine then runs through its vendor's official API when that key is set, and through OpenRouter otherwise — mix the two freely, engine by engine, and the app shows you the active route on every row. Images are the one exception: covers and illustrations needGEMINI_API_KEY, there is no fallback for them.
Grounding depends on the route. In grounded ("full") runs the engines search the live web like this:
- ChatGPT — official OpenAI
web_searchwith real citations. Through OpenRouter it gets no web search at all, so this key is a real upgrade. - Claude, Gemini — official
web_search/google_searchwith real citations; the OpenRouter route serves these models without a search tool. - Grok — official xAI Live Search with real citations; through OpenRouter, the web plugin.
- Perplexity — Sonar searches on every call, on both routes.
- DeepSeek — the vendor API has no web search: on the official route a grounded run returns a plain answer with no citations. The OpenRouter route keeps its web plugin, so leave
DEEPSEEK_API_KEYempty if citations matter more than a direct connection.
| Variable | What it unlocks |
|---|---|
DATAFORSEO_* / KEYSSO_API_KEY |
competitor & keyword SEO data |
RESEND_API_KEY / SMTP_FROM |
weekly report emails |
YANDEX_* (OAuth) |
Yandex Metrica — AI-assistant traffic |
GOOGLE_* / GSC_REDIRECT_URI |
Google Search Console |
OSS_UNLOCKED |
1 = all features on, no paywall (default) |
flowchart LR
U([You]) --> WEB[web · Vue 3 SPA<br/>nginx :8080]
WEB -->|/api, /graphql| API[server · NestJS :4000]
API --> DB[(PostgreSQL 16)]
API --> REDIS[(Redis 7)]
REDIS <--> WORKER[worker · BullMQ]
WORKER --> LLM{{LLM engines<br/>OpenRouter / native}}
WORKER --> DB
| Layer | Stack |
|---|---|
| Dashboard | Vue 3 · Vite · Tailwind v4 |
| API & Worker | NestJS · Prisma · BullMQ |
| Data | PostgreSQL 16 · Redis 7 |
| Models | OpenRouter, or native provider keys |
The dashboard is bilingual (English / Русский) via a frontend i18n layer. Backend messages default to English; language-dependent product content (weekly reports, LLM prompts) is generated in the language of the tracked site. New UI locales are welcome — they live in the frontend translation dictionaries.
- More answer engines & regional assistants
- Per-country geo-targeting for the answer engines
- Scheduled PDF/email visibility reports out of the box
- One-click deploy templates (Railway / Render / Coolify)
Issues and PRs are very welcome. Spin it up locally, break something, send a fix. If you add a feature that touches the UI, keep it token-driven so it works in both themes.
AGPL-3.0 — free to self-host, modify and use commercially. If you run a modified version as a network service, you have to share your changes under the same license. Same deal as Postiz, Grafana and friends.
Built for a world where the answer box is the new front page.