niubigeo: kiểm tra AI nhắc đến thương hiệu bạn ra sao — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về Albert-Weasker/niubigeo — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: niubigeo: kiểm tra AI nhắc đến thương hiệu bạn ra sao — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
niubigeo (NiubiGEO) là công cụ mã nguồn mở, tự cài trên máy, giúp kiểm tra thương hiệu và đối thủ của bạn xuất hiện thế nào trong câu trả lời của các mô hình AI. Bạn nhập tên miền, chọn mô hình, rồi đọc câu trả lời gốc, đối thủ được nhắc và nguồn trích dẫn. Cài khá dễ nếu đã có Node.js 22.13 trở lên và một khoá OpenRouter API; chi phí gọi mô hình do bạn tự trả.
niubigeo (tên đầy đủ NiubiGEO) là một công cụ mã nguồn mở để xem các mô hình AI nói gì về sản phẩm của bạn. Bạn nhập một tên miền, chọn vài mô hình, rồi đọc câu trả lời gốc, thấy đối thủ nào được nhắc và nguồn nào được dẫn. Công cụ chạy trên máy bạn, dùng khoá API của chính bạn.
Vấn đề nó giải quyết khá đời thường. Bạn làm sản phẩm, viết tài liệu, quảng bá. Nhưng khi khách hỏi AI «có công cụ nào làm việc này không?», sản phẩm của bạn có nằm trong câu trả lời không? Nhiều dịch vụ GEO (tối ưu để xuất hiện trong câu trả lời AI) chỉ đưa ra một con số khó kiểm chứng. niubigeo làm ngược lại: đưa bằng chứng ra trước.
Người nên thử là chủ doanh nghiệp nhỏ, người làm marketing, làm sản phẩm, và lập trình viên muốn tự kiểm tra mà không phải thuê dịch vụ. Điểm đáng giá nhất là mọi kết quả đều lần ngược được về câu trả lời gốc, có lưu lịch sử để so sánh các lần chạy. Hiện repo có khoảng 10.246 sao và 822 fork, giấy phép Apache-2.0.
Albert-Weasker/niubigeo
Công cụ mã nguồn mở tự chạy trên máy bạn, cho biết các mô hình AI mô tả sản phẩm của bạn thế nào, nhắc đối thủ nào và dẫn nguồn nào.
I.niubigeo làm được gì
Theo README, công cụ xoay quanh một chuỗi: câu hỏi, mô hình AI, câu trả lời gốc, thương hiệu được nhắc, đối thủ, nguồn trích dẫn, rồi 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ần chạy và bằng chứng riêng. Bạn không bị trộn sản phẩm này vào báo cáo của sản phẩm kia.
- So sánh nhiều mô hình. Bạn chọn một hoặc nhiều mô hình, mỗi mô hình trả lời độc lập. Một mô hình lỗi thì kết quả của các mô hình còn lại vẫn giữ nguyên, và bạn có thể chạy 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. Bạn đặt mỗi mô hình chạy offline hoặc dùng chế độ tìm kiếm có sẵn của nó. Kết quả lưu lại đúng điều kiện đã chạy.
- Xem AI mô tả sản phẩm thế nào. Mô tả công việc kinh doanh, danh mục, sản phẩm cạnh tranh và từ khoá đi kèm được xếp cạnh nhau để so.
- Xem ai xuất hiện khi không nêu tên thương hiệu. Bạn xác nhận từ khoá rồi thử mà không đưa tên thương hiệu vào câu hỏi. Nhờ đó thấy ai thật sự được nhắc hoặc được gợi ý.
- Kiểm tra bằng chứng. Câu trả lời gốc, vị trí trong văn bản, nguồn do nhà cung cấp mô hình trả về và đường link thường trong câu trả lời được hiển thị tách biệt. Lỗi và chỗ chưa chắc chắn vẫn được giữ lại.
- Theo dõi từ khoá (Keyword Monitoring, bản v0.3, ghi là BETA). Bạn tự đặt từ khoá, nhập hàng loạt, phân loại câu hỏi (Discovery, Alternative, Comparison, Brand, Use case), dùng mẫu có sẵn, đặt tần suất theo giờ, ngày hoặc tuần, và so sánh hai lần chạy bằng Diff View.
- Kết nối nhiều nguồn mô hình. Bản v0.2.1 cho phép trộn OpenRouter, API trực tiếp của nhà cung cấp và endpoint tương thích OpenAI trong cùng một lần thử.
Lưu ý giới hạn mà chính README nói rõ: bản v0.3 chưa có bảng điều khiển riêng để phát hiện đối thủ. Phạm vi hiện tại là theo dõi từ khoá, lưu lịch sử độc lập và so sánh thay đổi.
II.Cần chuẩn bị gì
Theo tư liệu, bạn cần:
- Node.js 22.13 trở lên (file package.json yêu cầu Node từ 22).
- Git để tải mã nguồn về.
- Một khoá OpenRouter API (biến
OPENROUTER_API_KEY) để thử sản phẩm của riêng bạn. - Chi phí gọi mô hình và tìm kiếm do bạn tự trả, cùng chi phí máy chủ nếu bạn tự đặt lên server. README nhấn mạnh phần này tách riêng khỏi công cụ.
Tư liệu chưa nói gì về yêu cầu phần cứng hay GPU, và cũng chưa nêu rõ hệ điều hành. Vì công cụ gọi mô hình qua API nên chắc chắn không cần bạn tự chạy mô hình, nhưng yêu cầu máy cụ thể thì README phần mình có chưa ghi.
Nếu chưa muốn cài gì, README cho biết có 20 trường hợp thật để xem trước, không cần cài đặt hay khoá API.
Mỗi lần thử sản phẩm của bạn đều tốn tiền gọi mô hình và tìm kiếm. Hãy bắt đầu với một mô hình, xem chi phí thực tế trên tài khoản OpenRouter rồi mới thêm mô hình. Không gửi file .env hay khoá API cho ai và không đưa lên GitHub.
III.Cài đặt từng bước
- Tải mã nguồnDùng git clone bản v0.3.3 rồi vào thư mục niubigeo
- Cài thư việnChạy npm ci để cài đúng các gói đã khoá phiên bản
- Tạo file cấu hìnhSao chép .env.example thành .env
- Điền khoá APIĐiền OPENROUTER_API_KEY vào file .env
- Chạy ứng dụngChạy npm run server rồi mở http://localhost:8787
A.Tải mã nguồn về máy
Mở terminal (PowerShell trên Windows, Terminal trên macOS hoặc Linux) ở thư mục bạn muốn đặt dự án. Lệnh dưới tải bản v0.3.3, chỉ lấy lịch sử mới nhất cho nhẹ, rồi bước vào thư mục dự án.
git clone --branch v0.3.3 --depth 1 https://github.com/Albert-Weasker/niubigeo.git
cd niubigeoChỗ người mới hay vấp: các lệnh sau phải chạy bên trong thư mục niubigeo. Nếu báo không tìm thấy package.json, bạn đang đứng sai thư mục.
B.Cài thư viện
npm ciLệnh này cài các gói theo đúng file package-lock.json của dự án. Cần có Node.js 22.13 trở lên. Bạn có thể kiểm tra bằng node --version.
C.Tạo file cấu hình
cp .env.example .envLệnh này tạo file .env từ file mẫu. Trên PowerShell, cp là bí danh của Copy-Item nên cũng chạy được. Nếu dùng Command Prompt (cmd) cũ, bạn có thể tự sao chép file bằng File Explorer và đổi tên thành .env.
D.Điền khoá API
Mở file .env bằng trình soạn thảo văn bản, tìm dòng OPENROUTER_API_KEY và điền khoá của bạn sau dấu bằng. File mẫu còn liệt kê các biến khác như OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, PERPLEXITY_API_KEY, DEEPSEEK_API_KEY, PORT và RUNS_DIR. README hướng dẫn bắt đầu chỉ với OPENROUTER_API_KEY.
OPENROUTER_API_KEY=khoa-cua-banThay khoa-cua-ban bằng khoá thật, lưu file lại. Nhớ lưu trước khi chạy ứng dụng.
E.Chạy ứng dụng
npm run serverSau khi chạy, mở trình duyệt vào địa chỉ 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.
F.Muốn chạy bằng Docker
Repo có sẵn Dockerfile và docker-compose.yml. README có nhắc «Docker guide» nhưng phần mình có chưa ghi lệnh Docker đầy đủ, nên bạn xem hướng dẫn trong thư mục docs/ của repo. README chỉ ghi rõ một lệnh: docker compose up -d, dùng để tạo lại container web sau khi đổi cấu hình. Người dùng cũ cần đọc mục sao lưu và nâng cấp (Backups and upgrades) trong tài liệu trước khi nâng cấp.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra đơn giản nhất theo README: sau npm run server, mở http://localhost:8787. Nếu thấy giao diện công cụ và tạo được dự án đầu tiên thì cài đặt đã ổn.
Sau đó thử một vòng nhỏ:
- Nhập một tên miền, ví dụ tên miền sản phẩm của bạn. Dự án được lưu trước khi bạn bắt đầu thử.
- Chọn một mô hình và lưu cấu hình.
- Bắt đầu thử, rồi mở kết quả. Nếu thấy mô tả sản phẩm, đối thủ, từ khoá và câu trả lời gốc, khoá API của bạn đang hoạt động.
Nếu mô hình báo lỗi, README nói các mô hình khác vẫn giữ kết quả. Bạn có thể xem lỗi và chạy lại riêng mô hình đó.
Bạn cũng sẽ thấy một thẻ nhỏ «video advisor» (cố vấn video). Đó là đường dẫn tới dịch vụ bên ngoài, không bắt buộc, không cần API key và không gửi dữ liệu dự án. Muốn ẩn thẻ này, đặt NIUBIGEO_VIDEO_ADVISOR_ENABLED=false trong .env rồi khởi động lại máy chủ. README cho biết 0 và off cũng có tác dụng tương tự.
V.Dùng vào việc thật
A.Chủ một phần mềm nhỏ muốn biết AI mô tả mình thế nào
Bạn bán một phần mềm quản lý công việc. Bạn tạo dự án với tên miền của mình, chọn hai hoặc ba mô hình rồi chạy bài kiểm tra tên miền. Kết quả cho thấy từng mô hình mô tả sản phẩm là gì, xếp vào nhóm nào và nhắc đối thủ nào.
Nếu một mô hình mô tả sai, bạn mở câu trả lời gốc để xem nó nói chính xác điều gì. README gợi ý hướng xử lý: mô tả sai có thể dẫn bạn quay lại trang web hoặc tài liệu của mình để làm rõ hơn. README cũng nhắc rằng nhận ra một tên miền sau khi được hỏi không đồng nghĩa với việc tự động gợi ý nó.
B.Người làm marketing kiểm tra ai xuất hiện khi không gọi tên thương hiệu
Bạn xác nhận vài từ khoá, ví dụ một nhóm công cụ bạn đang cạnh tranh, rồi chạy kiểm tra từ khoá mà không đưa tên thương hiệu vào. Công cụ cho thấy câu trả lời nào nêu tên một sản phẩm thật, câu nào chỉ giải thích khái niệm.
README minh hoạ bằng ví dụ Figma với từ khoá Prototyping: hai câu trả lời offline chủ yếu giải thích khái niệm, còn câu trả lời có yêu cầu tìm kiếm web thì nêu tên Figma. Từ đó bạn phân biệt được việc được nhắc tên, được mô tả tích cực và được khuyên dùng rõ ràng là ba chuyện khác nhau.
Một câu trả lời không phải là bảng xếp hạng vĩnh viễn, nên đừng tin con số nào mà bạn không mở được câu trả lời gốc phía sau.
Ông T
C.Theo dõi thay đổi sau khi sửa nội dung website
Bạn vừa viết lại trang giới thiệu hoặc đăng bài mới. Bạn dùng mô-đun theo dõi từ khoá: nhập từ khoá (có mẫu sẵn như AI Coding, SaaS, GEO, so sánh), chọn tần suất giờ, ngày hoặc tuần, tuỳ chọn khai báo thương hiệu và tên gọi khác của nó. Sau ít nhất hai lần chạy, Diff View so sánh các lần chạy đã lưu: gợi ý nào được thêm hoặc mất, vị trí nào thay đổi, nguồn nào thêm.
Hai điều cần nhớ. Chạy theo lịch đòi hỏi tiến trình giám sát (monitoring worker) phải đang chạy. Và README nói rõ vài phút thử lặp lại không chứng minh được tăng trưởng dài hạn.
D.Lập trình viên kiểm tra nguồn trích dẫn
Bạn là dev, muốn biết mô hình dựa vào trang nào để trả lời. Mở một kết quả, xem phần nguồn do nhà cung cấp mô hình trả về, tách riêng với các URL thường nằm trong câu trả lời. Từ nguồn lần ngược về câu trả lời tương ứng. Ví dụ PostHog trong README với từ khoá Feature Flags có trích dẫn tới nhiều trang, trong đó có một bài blog.
Cũng theo README, một nguồn trích dẫn giúp bạn kiểm tra câu trả lời, nhưng không tự giải thích vì sao mô hình đưa ra gợi ý đó. Công cụ này còn cho xuất lịch sử từ khoá ra CSV hoặc JSON ở bản v0.3.3, tiện đưa sang bảng tính.
VI.Lỗi hay gặp và cách xử lý
Báo cần phiên bản Node cao hơn, hoặc npm ci lỗi. Dự án yêu cầu Node.js 22.13 trở lên. Kiểm tra bằng node --version. Nếu thấp hơn, cài bản Node mới hơn từ trang chủ Node.js rồi mở terminal mới và chạy lại npm ci.
Chạy npm ci báo không thấy package.json. Bạn đang đứng sai thư mục. Chạy cd niubigeo để vào đúng thư mục dự án rồi thử lại.
Ứng dụng mở được nhưng mô hình trả lỗi. Nguyên nhân dễ gặp nhất là khoá API sai, thiếu tiền trong tài khoản hoặc quên lưu file .env. Kiểm tra lại dòng OPENROUTER_API_KEY, lưu file, dừng máy chủ bằng Ctrl+C rồi chạy lại npm run server. Mô hình lỗi có thể chạy lại riêng mà không mất kết quả của mô hình khác.
Mở http://localhost:8787 không được. Kiểm tra terminal đang chạy npm run server có báo lỗi không. Nếu cổng bị chiếm, file mẫu có biến PORT để đổi cổng. Tư liệu chưa nói chi tiết cách xử lý khi cổng đã bị dùng, nên hãy xem thư mục docs/ nếu vẫn kẹt.
Lịch theo dõi không tự chạy. README nói chạy theo lịch cần monitoring worker đang chạy. Nếu chỉ khởi động máy chủ mà chưa bật worker thì các lần chạy theo lịch sẽ không có. Cách bật worker README phần mình có chưa ghi, bạn xem hướng dẫn theo dõi từ khoá trong docs/.
VII.Có nên dùng không
Điểm mạnh. Công cụ miễn phí, mã nguồn mở, tự cài và tự chọn nơi lưu dữ liệu. Bạn chọn mô hình theo khoá API của mình. Mọi quan sát đều quay về được câu trả lời gốc, và lần chạy lỗi vẫn được lưu. Cách làm này trung thực hơn một con điểm không giải thích.
Giới hạn. Cài bằng dòng lệnh nên người hoàn toàn chưa dùng terminal sẽ thấy hơi ngợp bước đầu. Bạn tự trả phí mô hình, tìm kiếm và máy chủ. Tự cài không có nghĩa là dữ liệu không rời máy: README cảnh báo các API mô hình bên ngoài có thể nhận những câu hỏi bạn gửi. Mô-đun theo dõi từ khoá còn ở mức BETA, chưa có bảng điều khiển phát hiện đối thủ riêng. Và một câu trả lời AI không đại diện cho mọi hệ thống AI.
Khi nào 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 hoặc 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 nói đó chỉ là gợi ý chọn, không phải bảng xếp hạng. Nhóm tác giả có bán thêm dịch vụ chẩn đoán và tối ưu GEO nhưng không bắt buộc để dùng công cụ.
Nếu bạn muốn tự kiểm chứng AI đang nói gì về sản phẩm mình và chấp nhận một chút thao tác kỹ thuật, niubigeo là điểm khởi đầu hợp lý. Hãy xem 20 trường hợp mẫu trước khi cài.
Câu hỏi thường gặp
niubigeo có miễn phí không?
Mã nguồn mở, giấy phép Apache-2.0, nên dùng công cụ không mất phí bản quyền. Tuy vậy chi phí gọi API mô hình, tìm kiếm và hạ tầng máy chủ do bạn tự trả. Tác giả có bán thêm dịch vụ riêng như chẩn đoán và tối ưu GEO nhưng không bắt buộc.
Cần những gì để cài niubigeo?
Theo README, bạn cần Node.js 22.13 trở lên và một khoá OpenRouter API. Bạn tải mã bằng git, chạy npm ci, tạo file .env rồi chạy npm run server. Sau đó mở http://localhost:8787.
Có cần GPU không?
Tư liệu không nhắc yêu cầu GPU. Công cụ gọi các mô hình qua API (như OpenRouter) chứ không bảo bạn tự chạy mô hình trên máy mình. Yêu cầu phần cứng cụ thể thì chưa có thông tin trong README.
Dữ liệu của mình có an toàn không?
Bạn tự chọn nơi lưu từ khoá, danh sách đối thủ và lịch sử nghiên cứu vì công cụ tự cài. Nhưng README cảnh báo tự cài không có nghĩa là không lộ dữ liệu: các API mô hình bên ngoài có thể nhận những câu hỏi bạn gửi. Thẻ video advisor chỉ là liên kết, không gửi dữ liệu dự án hay khoá API.
Có chạy Windows được không?
README không ghi rõ danh sách hệ điều hành được hỗ trợ. Công cụ chạy trên Node.js 22.13 trở lên và có cả Docker, nên về nguyên tắc cài được ở nơi có các thành phần đó, nhưng mình chưa có thông tin xác nhận chính thức cho Windows.
niubigeo khác gì các dịch vụ GEO trả phí?
Theo README, niubigeo ưu tiên bằng chứng: bạn xem câu trả lời gốc, nguồn trích dẫn và lịch sử các lần chạy thay vì một con điểm không giải thích. Công cụ tự cài và dùng khoá API của bạn. Dịch vụ thương mại phù hợp hơn khi bạn cần nền tảng có người vận hành, quy trình marketing hoặc dữ liệu tìm kiếm có sẵn.
Có chạy bằng Docker được không?
Có, repo có Dockerfile và docker-compose.yml, và README nhắc một hướng dẫn Docker riêng. Phần README mình có chưa ghi đầy đủ các lệnh, nên bạn xem thư mục docs/ trong repo. README chỉ ghi lệnh docker compose up -d để tạo lại container web sau khi đổi cấu hình.


