跳到正文

Albert-Weasker

niubigeo

Open-source AI brand visibility and competitor reports

README 已保存到本站,可直接阅读

Documentation snapshot

README 快照

这篇是英文原文

下面正文是项目自己的英文 README。想读全文就用浏览器自带的整页翻译: Chrome / Edge 点地址栏右侧的翻译图标,或用右键菜单里的「翻译成中文」; 手机浏览器一般在菜单里。

本页保存的是公开项目资料快照,阅读过程不需要连接 GitHub。

Does AI recommend your product? Who shows up instead?

Enter a domain and see whether AI recommends you, which competitors appear, and which sources shape the answer.

Next Preview · 简体中文 · Quick start · Releases · Packages · Compare tools

NiubiGEO Next Preview is available: Read the redesigned AI domain-recognition monitor · 查看简体中文预告

图片:Alpha 图片:Open Source 图片:Self-hosted 图片:BYOK 图片:English


[!IMPORTANT] NiubiGEO Next Preview is available. The next version moves from one-time AI visibility audits to long-term AI domain-recognition monitoring. Read the preview / 简体中文.

You shipped a product. Does AI know it exists?

More users now ask AI directly instead of clicking through a page of search results:

What tools should I use?
What products exist in this category?
What are the alternatives to this product?
Which one should I choose?

Your website may already be indexed by search engines, but AI may still:

  • miss your brand entirely;
  • misunderstand your positioning;
  • remember only part of your product;
  • recommend competitors first;
  • cite third-party pages while ignoring your official site.

NiubiGEO does not hide this behind an unexplained score. It shows the questions, answers, competitors, and sources so you can understand how AI sees your market.

What you get from one audit

How AI understands your brand

See which models recognize your brand, how they describe your product, and what they leave out.

Who AI treats as competitors

When users do not mention your brand, see which products AI brings up instead. NiubiGEO separates confirmed competitors from loosely related names.

Where your brand is missing

Find customer questions where competing products appear and your product does not.

Which sources shape the answer

Review the official, community, and third-party sources cited by AI, then open the original answer behind each conclusion.

Data source: Community Edition generates results with the provider API you configure. Every conclusion links back to the question, model answer, and citation sources behind it.

A report founders can actually read

NiubiGEO does not require you to understand a pile of GEO metrics. The report answers plain business questions:

Summary
├── Does AI recognize your product?
├── How does AI describe your brand?
├── Who are the confirmed competitors?
├── Which questions surface competitors more often?
├── Which important questions miss your brand?
└── Which sources support these conclusions?

The main report stays focused on readable conclusions. Full AI answers are collapsed by default and can be opened when you want to inspect the evidence.

Why open source?

We want every team to understand how they appear in AI answers at a low cost, with a way to verify every conclusion.

NiubiGEO lets you:

  • self-host for free and use your own provider keys;
  • review every test question before it runs;
  • open the original AI answer behind each conclusion;
  • inspect how brands, competitors, and citation sources were identified.

3-minute audit

Docker

git clone https://github.com/Albert-Weasker/niubigeo.git
cd niubigeo
cp .env.example .env

Add at least one provider key to .env:

OPENROUTER_API_KEY=
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
GEMINI_API_KEY=
PERPLEXITY_API_KEY=
DEEPSEEK_API_KEY=

Start the app:

docker compose up --build

Open http://localhost:8787, enter a domain, confirm the brand, competitors, and questions, then run the audit.

You can also pull the published image:

docker pull ghcr.io/albert-weasker/niubigeo:v0.1.0-alpha

Run with Node.js

NiubiGEO requires Node.js 22 or newer.

git clone https://github.com/Albert-Weasker/niubigeo.git
cd niubigeo
cp .env.example .env
npm install
npm run self-check
npm run server

Run from CLI

npm run audit -- \
  --domain example.com \
  --provider openrouter \
  --models openai/gpt-4o-mini,perplexity/sonar \
  --prompt-count 8

Add keywords and your own customer questions:

npm run audit -- \
  --domain example.com \
  --keywords "category keyword,buyer intent keyword" \
  --competitors rival.com,other.com \
  --prompts "What are the best tools in this category?|What are the alternatives?"

Reports are saved in the local runs/ directory by default.

Supported providers

ProviderStatusHow it is used
OpenRouterSupportedOne key can run models from multiple providers; native web plugin supported
OpenAISupportedUses the official OpenAI Responses API; native web_search supported
AnthropicSupportedUses the official Anthropic Messages API; native Claude web search supported
Google GeminiSupportedUses the official Gemini API; Google Search grounding supported
PerplexitySupportedUses Sonar web-grounded answers and Provider-returned citations
DeepSeekSupportedUses DeepSeek Responses-compatible API; native web_search supported
OpenAI-compatible APISupportedCustom gateways via OPENAI_COMPATIBLE_BASE_URL and OPENAI_COMPATIBLE_API_KEY

See Provider-native web search for the exact execution paths and source-labeling rules.

Packages

The Docker image is published on GitHub Container Registry:

docker pull ghcr.io/albert-weasker/niubigeo:v0.1.0-alpha
docker pull ghcr.io/albert-weasker/niubigeo:latest

Bilingual by design

NiubiGEO supports English and Simplified Chinese. The language setting affects:

  • the product interface;
  • automatically generated monitoring questions;
  • prompts sent to the provider;
  • brand and competitor analysis;
  • the final report.

NiubiGEO vs commercial AI visibility tools

Commercial AI visibility platforms are usually a better fit for teams ready to buy hosted software, proprietary datasets, and team workflows. NiubiGEO is for teams that want to start with open source, control their models and questions, and keep the evidence close.

The comparison below is based on public information from each product’s official website, last checked on 2026-09-03. Product capabilities change over time; verify current details on the vendor’s own website.

NiubiGEO vs Profound

  • Choose Profound: Best for organizations that need hosted enterprise monitoring, mature marketing workflows, and large-scale data capabilities.
  • Choose NiubiGEO: Best for teams that want to start free, self-host, choose their own models, and inspect the underlying evidence.

View Profound

NiubiGEO vs Peec AI

  • Choose Peec AI: Best for marketing teams that want a hosted product for continuous brand tracking out of the box.
  • Choose NiubiGEO: Best for users who do not want to start with a SaaS subscription and want control over questions, models, and data.

View Peec AI

NiubiGEO vs Otterly.AI

  • Choose Otterly.AI: Best for teams that need hosted AI search monitoring, scheduled reports, and optimization workflows.
  • Choose NiubiGEO: Best for teams that want to use their own API keys to quickly verify whether AI recommends their brand.

View Otterly.AI

NiubiGEO vs Semrush AI Visibility

  • Choose Semrush: Best for teams already using Semrush that want AI visibility inside a broader SEO and marketing data stack.
  • Choose NiubiGEO: Best for users who do not need proprietary SEO data and want an inspectable report around their own questions and models.

View Semrush AI Visibility

NiubiGEO vs Ahrefs Brand Radar

  • Choose Ahrefs: Best for SEO teams that need large-scale keyword data, search demand, and AI visibility indexes.
  • Choose NiubiGEO: Best for teams that want to define their own questions, run their own models, and start from a local auditable report.

View Ahrefs Brand Radar

NiubiGEO vs AthenaHQ

  • Choose AthenaHQ: Best for organizations that need a full GEO workflow, action recommendations, and team collaboration.
  • Choose NiubiGEO: Best for teams that first want to understand whether AI knows their brand, which sources it cites, and who the competitors are.

View AthenaHQ

NiubiGEO vs Scrunch

  • Choose Scrunch: Best for teams that need enterprise monitoring, optimization guidance, and AI-agent content delivery.
  • Choose NiubiGEO: Best for users who want to start with an open-source AI brand audit and keep the evidence chain visible.

View Scrunch

View quick comparison table

CapabilityNiubiGEOCommercial platforms
AI brand visibilitySupportedUsually supported
Competitor analysisSupportedUsually supported
Citation/source analysisSupportedUsually supported
Open sourceSupportedUsually not offered
Self-hostingSupportedUsually not offered
Bring your own provider keySupportedUsually not offered
Hosted infrastructureNot includedUsually included
Proprietary datasetsNot includedUsually included
Team workflowsPlannedUsually included

Trademarks and product names belong to their respective owners.

How it works

flowchart LR
    A[Enter domain] --> B[Discover brand and competitors]
    B --> C[Confirm real customer questions]
    C --> D[Call provider APIs]
    D --> E[Analyze answers and sources]
    E --> F[Generate readable report]
  1. Enter a domain or product page.
  2. NiubiGEO identifies the brand, aliases, category, keywords, and possible competitors.
  3. The user confirms or edits the questions before any provider call.
  4. The system calls the configured provider API.
  5. NiubiGEO analyzes the target brand, competitors, recommendations, and provider-returned sources.
  6. It generates a short, readable report where every conclusion links back to evidence.

Project status

NiubiGEO is currently v0.1.0-alpha: the core flow works, while interfaces, data structures, and report rules may still change.

  • Multi-provider API audits
  • Question confirmation before audit
  • Brand and competitor discovery
  • Confirmed competitors separated from possibly related brands
  • Relevant source filtering
  • Reports traceable to AI answers
  • English and Simplified Chinese
  • Scheduled monitoring
  • Report comparison under the same audit conditions
  • Report export package
  • Provider Plugin SDK
  • More providers and compatible endpoints

Need to verify what real users see?

Community Edition is for running your own API visibility audits. If you also need:

  • human testing across countries and regions;
  • consumer web UI checks for ChatGPT, Gemini, Claude, Perplexity, and similar products;
  • screenshots, sources, and complete evidence packages;
  • GEO optimization plans based on the competitive gaps found in the audit;

you can explore NiubiGEO Managed Service, powered by the NiubiStar global user network.

View data source and result boundaries

  • Community Edition uses provider APIs and does not simulate consumer web UI results.
  • API answers can differ from consumer product answers.
  • Citations only come from provider responses or sources that appear in the AI answer.
  • OpenRouter can call models from different providers, but the result is still labeled as OpenRouter API.
  • Provider keys do not cross boundaries. For example, an OpenAI key only calls OpenAI, and a Gemini key only calls Gemini.
  • Without a provider key, NiubiGEO does not produce AI visibility results.
  • The core audit path never treats mock data as a substitute for real provider answers.
  • AI answers are stochastic; one audit is not a permanent ranking.
  • Human regional testing and consumer web UI verification are separate services.

View security and license notes

Do not commit provider keys, customer reports, private prompts, or run data containing sensitive information. Report security issues privately through SECURITY.md.

NiubiGEO is licensed under Apache-2.0.

Contributing

Contributions are welcome for new providers, entity recognition rules, source filtering rules, report language improvements, and documentation.

  • Read CONTRIBUTING.md
  • File bugs in Issues
  • Discuss features in Discussions

Contributors

Thanks to everyone building NiubiGEO.

Albert-Weasker

See the full contributor graph on GitHub.


Enter a domain and see whether AI recommends your product for the questions that matter.

Get started · File an issue · Read Chinese docs

Built by NiubiStar

Official distribution

获取与安装

暂未发现可确认的官方软件包地址

当前 README 快照没有出现 npm、PyPI、Crates.io、pub.dev 等官方包页链接。本站不会根据仓库名称猜测下载地址。

本站不托管项目文件;需要安装时,请以项目维护者发布的官方文档为准。

使用前核验

本站保存公开资料用于阅读,不代表安全审计或功能背书。安装前请核对许可证、依赖来源和发布签名,不要直接运行来源不明的二进制文件或高权限脚本。