# niubigeo: xem AI nói gì về thương hiệu và đối thủ của bạn — hướng dẫn cài đặt và dùng

> niubigeo là công cụ mã nguồn mở (Apache-2.0) để theo dõi mức độ xuất hiện của thương hiệu và đối thủ trong câu trả lời của AI. Bạn nhập tên miền, chọn mô hình, rồi đọc câu trả lời gốc cùng nguồn trích dẫn. Cài đặt không khó nếu đã có Node.js 22.13 trở lên và một khoá OpenRouter.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-09-08 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/niubigeo-theo-doi-thuong-hieu-trong-cau-tra-loi-cua-ai-2

niubigeo là một ứng dụng web mã nguồn mở, bạn tự cài trên máy mình, để kiểm tra xem các mô hình AI (kiểu ChatGPT, Claude, Gemini…) đang nói gì về sản phẩm của bạn. Nó trả lời những câu hỏi rất thực tế: AI gọi thương hiệu của bạn là gì, nó nghĩ bạn làm gì, đối thủ nào hay đi kèm, và nguồn nào được trích dẫn.

Người nên dùng: chủ shop, chủ doanh nghiệp nhỏ, người làm marketing, nhóm sản phẩm và lập trình viên muốn biết khi khách hỏi AI “nên dùng công cụ nào”, tên mình có được nhắc không. Repo hiện có khoảng 10247 sao và 822 fork, viết bằng TypeScript, giấy phép Apache-2.0.

Điểm đáng giá nhất là công cụ không đưa cho bạn một con số “điểm GEO” khó hiểu. Mỗi nhận xét đều mở ra được câu trả lời gốc của mô hình, nên bạn tự kiểm chứng và lặp lại bài kiểm tra về sau. Đổi lại, bạn tự trả phí gọi API mô hình, tự lo máy chạy.

```repo
- repo | Albert-Weasker/niubigeo
- kind | Ứng dụng
- desc | niubigeo là công cụ mã nguồn mở, tự cài, giúp xem các mô hình AI mô tả thương hiệu của bạn thế nào, nhắc đối thủ nào và trích nguồn nào.
- stars | 10k
- lang | TypeScript
- license | Apache-2.0
```

## niubigeo làm được gì

Tác giả mô tả luồng làm việc như sau: câu hỏi → mô hình AI → câu trả lời gốc → các lần nhắc tên → đối thủ → nguồn trích dẫn → lịch sử các lần chạy. Cụ thể:

- **Quản lý nhiều sản phẩm.** Mỗi tên miền là một dự án riêng, có cấu hình, lịch sử chạy và bằng chứng riêng. Bạn đổi qua lại mà không bị lẫn báo cáo.
- **So sánh nhiều mô hình.** Bạn tìm và chọn một hay nhiều mô hình. Mỗi mô hình trả lời độc lập, mô hình nào lỗi thì các kết quả còn lại vẫn giữ nguyên, và bạn thử lại riêng mô hình lỗi.
- **Bật hoặc tắt tìm kiếm web cho từng mô hình.** Kết quả ghi lại điều kiện chạy thực tế, nên bạn biết câu trả lời đó có tra web hay không.
- **Xem AI mô tả thương hiệu thế nào.** Mô tả ngành hàng, đối thủ và các từ khoá đi kèm được đặt cạnh nhau để so sánh.
- **Kiểm tra khi không nhắc tên thương hiệu.** Bạn xác nhận từ khoá, rồi chạy thử mà không đưa tên mình vào câu hỏi. Cách này cho thấy ai tự xuất hiện trong câu trả lời.
- **Kiểm chứng bằng chứng.** Câu trả lời gốc, vị trí trong văn bản, nguồn trích dẫn do nhà cung cấp trả về và các đường link thường trong câu trả lời được hiển thị tách bạch. Lần chạy lỗi cũng được giữ lại.
- **Theo dõi từ khoá (v0.3, ghi là bản BETA).** Bạn tự định nghĩa từ khoá, nhập hàng loạt, phân loại câu hỏi (Discovery, Alternative, Comparison, Brand, Use case), chọn tần suất theo giờ, ngày hoặc tuần, và so sánh hai lần chạy bằng chế độ Diff View.
- **Kết nối nhiều nguồn mô hình.** Dùng OpenRouter, API trực tiếp của hãng, hoặc endpoint tương thích OpenAI trong cùng một bài test.
- **Xuất dữ liệu.** Lịch sử từ khoá lọc được theo ngày UTC và mô hình, xuất CSV hoặc JSON.

README nói rõ phiên bản hiện tại chưa có bảng điều khiển phát hiện đối thủ riêng. Phạm vi của v0.3 là theo dõi từ khoá, lịch sử độc lập và so sánh thay đổi.

## Cần chuẩn bị gì

- **Node.js 22.13 trở lên.** package.json yêu cầu Node từ 22 trở lên, README ghi cụ thể 22.13+.
- **Git và npm** để tải mã nguồn và cài phụ thuộc (README dùng `git clone` và `npm ci`).
- **Khoá OpenRouter API** nếu muốn thử sản phẩm của bạn. File mẫu `.env.example` còn có chỗ cho khoá OpenAI, Anthropic, Gemini, Perplexity và DeepSeek, nhưng README hướng dẫn bắt đầu bằng OpenRouter.
- **Ngân sách gọi API.** Xem các ca mẫu thì miễn phí, nhưng test sản phẩm của bạn sẽ tốn phí mô hình và phí tìm kiếm.
- Hệ điều hành, RAM, GPU: tư liệu chưa nói gì về yêu cầu riêng. Ứng dụng gọi mô hình qua API nên chưa có dấu hiệu cần GPU, nhưng đây là suy đoán, không phải điều README xác nhận.

```note
Khoá API là chìa khoá tính tiền của bạn. Chỉ để trong file .env trên máy mình, không dán vào chat, không đưa lên GitHub. Nên đặt hạn mức chi tiêu ở trang nhà cung cấp trước khi chạy test hàng loạt.
```

## Cài đặt từng bước

```steps
- Tải mã nguồn | Clone đúng bản v0.3.3 về máy
- Cài phụ thuộc | Chạy npm ci trong thư mục dự án
- Tạo file .env | Sao chép từ .env.example
- Điền khoá | Ghi OPENROUTER_API_KEY vào .env
- Chạy ứng dụng | npm run server rồi mở trình duyệt
```

### Tải mã nguồn

Mở terminal (PowerShell hoặc Git Bash trên Windows, Terminal trên macOS/Linux) ở thư mục bạn muốn lưu dự án. Lệnh dưới tải đúng bản v0.3.3 và chỉ lấy lịch sử mới nhất cho nhẹ:

```bash
git clone --branch v0.3.3 --depth 1 https://github.com/Albert-Weasker/niubigeo.git
cd niubigeo
```

Dòng `cd niubigeo` rất quan trọng. Các lệnh phía sau phải chạy bên trong thư mục này, người mới hay quên bước đó.

### Cài phụ thuộc và tạo file .env

```bash
npm ci
cp .env.example .env
```

`npm ci` cài đúng các gói theo file khoá của dự án, có thể mất vài phút. Dòng `cp` tạo file `.env` từ bản mẫu. Nếu `cp` báo lỗi trong cửa sổ cmd cũ, hãy dùng PowerShell hoặc Git Bash, hoặc tự sao chép file `.env.example` thành `.env` bằng File Explorer.

### Điền khoá API

Mở file `.env` bằng trình soạn thảo bất kỳ, tìm dòng `OPENROUTER_API_KEY` và điền khoá của bạn sau dấu bằng. Lưu file. Trong `.env.example` còn các biến khác như `PORT`, `RUNS_DIR` (thư mục lưu các lần chạy) và `NIUBIGEO_VIDEO_ADVISOR_ENABLED`. Bạn chưa cần đổi gì ở đó.

### Chạy ứng dụng

```bash
npm run server
```

Sau đó mở trình duyệt vào `http://localhost:8787` để tạo dự án đầu tiên. Cửa sổ terminal phải để mở trong lúc dùng. Tắt terminal là ứng dụng dừng.

### Muốn chạy bằng Docker

Repo có `Dockerfile` và `docker-compose.yml`. README nhắc có “Docker guide” riêng và có nhắc lệnh `docker compose up -d` khi tạo lại container web, nhưng phần README mình có không ghi trọn các bước cài bằng Docker. Bạn xem hướng dẫn Docker trong thư mục `docs/` của repo trước khi làm.

## Kiểm tra đã chạy được chưa

Cách kiểm tra đơn giản nhất: sau `npm run server`, vào `http://localhost:8787`. Nếu thấy giao diện bàn làm việc (workbench) và tạo được dự án mới thì ứng dụng đã chạy. README không nêu dòng log cụ thể nào để đối chiếu.

Để chắc chắn khoá API ổn, bạn hãy tạo một dự án với tên miền của mình, chọn một mô hình rồi chạy test. Nếu nhận được câu trả lời gốc kèm phần mô tả và đối thủ thì mọi thứ đã thông. Nên bắt đầu với một mô hình, như README khuyên, để chi phí thấp.

Trên giao diện có một thẻ “video advisor” nhỏ trỏ sang dịch vụ bên ngoài. README nói thẻ này không tải script, iframe hay video của bên thứ ba và đường link không gửi dữ liệu dự án hay khoá API. Muốn ẩn, đặt `NIUBIGEO_VIDEO_ADVISOR_ENABLED=false` trong `.env` rồi khởi động lại.

## Dùng vào việc thật

### Chủ một công cụ SaaS nhỏ muốn biết AI mô tả mình ra sao

Bạn làm phần mềm quản lý kho và muốn biết khi khách hỏi AI, sản phẩm của bạn được giới thiệu thế nào. Tạo dự án bằng tên miền của bạn, chọn 2-3 mô hình, bật tìm kiếm web cho một mô hình và tắt ở mô hình còn lại. Chạy test rồi đọc phần mô tả và đối thủ.

Kết quả là bảng so sánh: mô hình nào mô tả đúng, mô hình nào nhầm ngành hàng, mô hình nào kể đối thủ nào. Nếu mô tả sai, README gợi ý quay lại sửa website hay tài liệu của bạn, rồi chạy lại.

### Nhân viên marketing kiểm tra “khi không nhắc tên mình thì ai xuất hiện”

Bạn xác nhận một từ khoá như “phần mềm quản lý kho cho cửa hàng nhỏ”, rồi chạy kiểm tra từ khoá mà không đưa tên thương hiệu vào câu hỏi. Mỗi câu trả lời được ghi lại kèm mô hình, điều kiện tìm kiếm và nguồn trích dẫn.

> Một lần nhắc tên, một lời khen và một lời đề xuất rõ ràng là ba chuyện khác nhau.
>
> — Ông T

Hãy đọc kỹ ba mức đó khi báo cáo cho sếp. Ví dụ trong README cho thấy một câu trả lời chỉ giải thích khái niệm, còn câu trả lời có bật tìm kiếm web thì nêu đích danh sản phẩm. Hai kết quả đó không thể gộp chung.

### Người làm nội dung theo dõi từ khoá theo tuần

Bạn vừa sửa lại trang giới thiệu sản phẩm và muốn biết AI có đổi cách trả lời không. Dùng module Keyword Monitoring: nhập danh sách từ khoá (hoặc dùng mẫu có sẵn như AI Coding, SaaS, GEO, so sánh), chọn tần suất hằng tuần, điền thương hiệu và các tên gọi khác của nó.

Sau hai lần chạy, mở Diff View để thấy khuyến nghị nào được thêm hay mất, thứ hạng đổi ra sao, nguồn nào mới xuất hiện. Lưu ý: lịch chạy tự động chỉ hoạt động khi tiến trình worker theo dõi đang chạy. Máy tắt thì không có lần chạy nào.

### Lập trình viên muốn đối chiếu nguồn trích dẫn

Bạn muốn biết trang nào đang được AI trích khi nói về lĩnh vực của mình. Mở kết quả của một lần chạy, xem nguồn do nhà cung cấp trả về (tách khỏi các URL thường trong câu trả lời), rồi lần theo nguồn đó về đúng câu trả lời. Xuất CSV hoặc JSON để đưa vào bảng tính hay báo cáo nội bộ.

README nhắc rằng một nguồn trích dẫn giúp bạn kiểm tra, nhưng tự nó không giải thích vì sao mô hình đề xuất một sản phẩm.

## Lỗi hay gặp và cách xử lý

### Báo lỗi phiên bản Node hoặc `npm ci` thất bại

Dự án yêu cầu Node 22 trở lên (README ghi 22.13+). Gõ `node -v` để xem phiên bản. Nếu thấp hơn, hãy cài Node mới từ trang chính thức rồi mở terminal mới và chạy lại `npm ci`.

### Chạy test nhưng mô hình trả lỗi hoặc không có kết quả

Thường là khoá API thiếu, sai hoặc hết hạn mức. Mở lại `.env`, kiểm tra `OPENROUTER_API_KEY` không có khoảng trắng thừa, rồi khởi động lại bằng `npm run server`. Sau khi sửa `.env`, ứng dụng cần được khởi động lại mới nhận. Nếu chỉ một mô hình lỗi, thử lại riêng mô hình đó theo cách README mô tả.

### Không mở được trang localhost:8787

Kiểm tra terminal chạy `npm run server` còn mở không và có báo lỗi gì không. Biến `PORT` có trong `.env.example`, nên nếu cổng 8787 bị chương trình khác chiếm, bạn có thể đổi `PORT` trong `.env` rồi vào địa chỉ với cổng mới.

### Lịch theo dõi từ khoá không chạy

README nói lịch chạy cần monitoring worker đang hoạt động. Hãy xem phần hướng dẫn Keyword Monitoring trong thư mục `docs/` để biết cách bật worker. Mình không chép lệnh ở đây vì phần README có trong tay chưa ghi lệnh đó.

### Tốn phí hơn dự kiến

Mỗi lần chạy với nhiều mô hình, nhiều từ khoá và tìm kiếm web đều tính phí API. Hãy bắt đầu với một mô hình và ít từ khoá. Phần theo dõi từ khoá còn có công cụ chạy lặp ở dòng lệnh với chế độ “dry run” đếm số request trước khi chạy thật. Hãy dùng tính năng này để ước lượng chi phí.

## Có nên dùng không

**Điểm mạnh.** Mã nguồn mở, tự cài, dùng khoá API của chính bạn. Dữ liệu nghiên cứu như từ khoá, danh sách đối thủ và lịch sử nằm trong môi trường của bạn. Mọi kết quả đều truy được về câu trả lời gốc, kể cả lần chạy lỗi, nên ít bị “điểm số hộp đen” đánh lừa.

**Giới hạn.** Bạn phải tự trả phí mô hình, tìm kiếm và máy chủ. Cần cài Node và chỉnh file `.env`, nên người hoàn toàn chưa đụng terminal sẽ thấy hơi khó. Tự cài không có nghĩa là không lộ dữ liệu: các câu hỏi bạn gửi vẫn đến nhà cung cấp mô hình bên ngoài. Module theo dõi từ khoá đang ở dạng BETA và README nói chưa có bảng điều khiển phát hiện đối thủ riêng. Chính tác giả cũng nhắc một câu trả lời không phải xếp hạng vĩnh viễn, và viết bài không bảo đảm được AI giới thiệu.

**Khi nên chọn cách khác.** Nếu bạn cần dịch vụ có người vận hành sẵn, quy trình marketing trọn gói hay dữ liệu tìm kiếm có sẵn, README gợi ý xem các nền tảng thương mại như Profound, Peec AI, Otterly.AI, Semrush AI Visibility, Ahrefs Brand Radar, AthenaHQ hay Scrunch. Tác giả cũng có dịch vụ trả phí riêng (kiểm thử AI bởi người thật, tối ưu GEO), và các dịch vụ này không bắt buộc để dùng bản mã nguồn mở.

Nếu bạn muốn tự nhìn xem AI nói gì về sản phẩm của mình, với ngân sách nhỏ và không ngại thao tác vài lệnh, niubigeo là lựa chọn đáng thử. Hãy bắt đầu với một mô hình, một tên miền và chỉ vài từ khoá.

## Câu hỏi thường gặp

### niubigeo có miễn phí không?

Mã nguồn mở theo giấy phép Apache-2.0 nên bạn dùng và tự cài miễn phí. Tuy vậy bạn phải tự trả phí gọi API mô hình, tìm kiếm và máy chủ. Tác giả cũng có dịch vụ trả phí riêng (kiểm thử AI bởi người thật, tối ưu GEO), nhưng không bắt buộc.

### Cần chuẩn bị gì để cài?

Bạn cần Node.js 22.13 trở lên, git, npm và một khoá OpenRouter API. Sau đó chạy git clone, npm ci, sao chép .env.example thành .env, điền khoá rồi chạy npm run server. README không nêu yêu cầu về RAM hay ổ cứng.

### Có cần GPU không?

Tư liệu không đề cập GPU. Ứng dụng gọi các mô hình qua API (OpenRouter, API trực tiếp hoặc endpoint tương thích OpenAI) nên có vẻ không cần GPU. README cũng có nhắc phần hướng dẫn Ollama, nhưng mình chưa có chi tiết về yêu cầu phần cứng khi dùng nó.

### Chạy được trên Windows không?

README chưa nêu hệ điều hành cụ thể. Các lệnh dùng git, npm và Node nên về nguyên tắc chạy được ở nơi cài được Node 22.13+. Dòng cp trong hướng dẫn có thể thay bằng việc tự sao chép file .env.example thành .env.

### Dữ liệu của tôi có an toàn không?

Khi tự cài, từ khoá, danh sách đối thủ và lịch sử nghiên cứu nằm trong môi trường của bạn. Tuy nhiên README nói rõ các API mô hình bên ngoài vẫn nhận các câu hỏi bạn gửi đi. Thẻ video advisor trên giao diện không gửi dữ liệu dự án hay khoá API và có thể tắt bằng một biến trong .env.

### niubigeo khác gì các nền tảng như Profound hay Semrush AI Visibility?

niubigeo là công cụ tự cài, dùng khoá API của bạn và cho xem câu trả lời gốc cùng nguồn của từng kết quả. README gợi ý các nền tảng thương mại phù hợp hơn nếu bạn cần dịch vụ có người vận hành, quy trình marketing hay dữ liệu tìm kiếm có sẵn. Đây là gợi ý lựa chọn của tác giả, không phải bảng xếp hạng.

### Tính năng theo dõi từ khoá đã ổn định chưa?

README gán nhãn v0.3 Keyword Monitoring là BETA. Tính năng gồm từ khoá tuỳ chỉnh, lịch chạy theo giờ, ngày hoặc tuần, lịch sử độc lập và Diff View. Lịch tự động chỉ chạy khi monitoring worker đang hoạt động.
