
NiubiGEO Ni Nini?
NiubiGEO ni zana ya chanzo huria inayojipangisha, kwa ajili ya kukagua jinsi mifumo ya AI inavyoelewa na kupendekeza bidhaa. Unaingiza kikoa, unakagua taarifa za chapa na maswali ya wateja yaliyotambuliwa, unachagua mtoa huduma wa AI aliyesanidiwa, kisha unatengeneza ripoti inayosomeka kuhusu mwonekano wa chapa yako.

Tofauti na zana zinazopunguza mwonekano kuwa alama isiyoelezeka, NiubiGEO hufanya ushahidi upatikane. Hitimisho lake linaunganisha swali la jaribio, jibu la awali la modeli, na vyanzo vyovyote vya marejeo vilivyorejeshwa na mtoa huduma.
NiubiGEO Community Edition hutumia API za watoa huduma. Haitoi tena matokeo kutoka kwenye violesura vya watumiaji kama tovuti za umma za ChatGPT, Claude, Gemini au Perplexity.
Ukaguzi Unaonyesha Nini
Ukaguzi wa NiubiGEO umeundwa kujibu maswali ya kibiashara kwa vitendo, badala ya kuwasilisha mkusanyiko mkubwa wa vipimo vya GEO visivyoeleweka.
- Utambuzi wa chapa: Bainisha kama modeli zilizochaguliwa zinatambua bidhaa yako na jinsi zinavyoielezea.
- Ugunduzi wa washindani: Ona ni bidhaa zipi zinazoonekana mteja anapouliza maswali kuhusu kategoria, ulinganisho au mapendekezo.
- Pengo la mwonekano: Tambua maswali muhimu ambapo washindani wanaonekana lakini chapa yako haionekani.
- Uchambuzi wa vyanzo: Kagua vyanzo rasmi, vya jumuiya na vya wahusika wengine vinavyoathiri jibu.
- Ukaguzi wa ushahidi: Fungua jibu la awali la AI linalounga mkono kila hitimisho la ripoti.
Mradi unatofautisha washindani waliothibitishwa na majina ambayo yanaweza tu kuwa na uhusiano wa mbali. Pia hukuruhusu kukagua na kuhariri maswali kabla ya simu za mtoa huduma kufanyika.
Vipengele Muhimu
- Community Edition ya chanzo huria yenye leseni ya Apache-2.0.
- Ujipangishaji bila malipo kwa kutumia funguo zako za API za watoa huduma.
- Msaada kwa watoa huduma na modeli nyingi za AI.
- Ugunduzi wa chapa, lakabu, kategoria, maneno muhimu na washindani.
- Uthibitishaji wa maswali kabla ya ukaguzi kuanza.
- Uchambuzi wa mapendekezo na marejeo yaliyorejeshwa na mtoa huduma.
- Ripoti zinazoweza kufuatiliwa hadi kwenye maswali na majibu yake ya msingi.
- Violesura, vidokezo, uchambuzi na ripoti kwa Kiingereza na Kichina Kilichorahisishwa.
Watoa huduma wanaoungwa mkono
NiubiGEO inasaidia OpenRouter, OpenAI, Anthropic, Google Gemini, Perplexity, DeepSeek na API zinazooana na OpenAI. Kulingana na mtoa huduma, inaweza kutumia utafutaji asilia wa wavuti, utafutaji wenye uimarishaji, majibu yanayotegemea wavuti au marejeo yaliyorejeshwa na mtoa huduma.
Ufunguo wa OpenRouter unaweza kufikia modeli kutoka kwa watoa huduma wengi, lakini maombi yanayotokana bado huwekewa lebo ya matokeo ya OpenRouter API. Kitambulisho cha kila mtoa huduma hubaki tofauti: ufunguo wa OpenAI huita OpenAI, huku ufunguo wa Gemini ukiita Gemini.
Mahitaji ya Awali
Njia ya haraka zaidi ya usakinishaji hutumia Docker na Docker Compose. Utahitaji pia angalau ufunguo mmoja wa API wa mtoa huduma anayeungwa mkono. Ukipendelea kuendesha chanzo moja kwa moja, sakinisha Node.js 22 au toleo jipya zaidi.
- Git
- Docker yenye Docker Compose, au Node.js 22+
- Ufunguo wa API wa angalau mtoa huduma mmoja anayeungwa mkono
- Kikoa au ukurasa wa bidhaa wa kukagua
Sakinisha NiubiGEO kwa Docker
1. Nakili hazina
git clone https://github.com/Albert-Weasker/niubigeo.git
cd niubigeo
cp .env.example .env2. Ongeza ufunguo wa mtoa huduma
Fungua .env na uongeze angalau ufunguo mmoja halali wa API. Huhitaji kusanidi kila mtoa huduma.
OPENROUTER_API_KEY=
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
GEMINI_API_KEY=
PERPLEXITY_API_KEY=
DEEPSEEK_API_KEY=Kwa mfano, ikiwa unapanga kutumia OpenAI, jaza OPENAI_API_KEY na uache sehemu za watoa huduma usiotumia zikiwa tupu.
3. Jenga na uanzishe programu
docker compose up --buildHuduma ikiwa tayari, fungua http://localhost:8787 kwenye kivinjari chako.
Kutumia picha ya kontena iliyochapishwa
Picha ya alpha iliyojengwa awali inapatikana kwenye GitHub Container Registry:
docker pull ghcr.io/albert-weasker/niubigeo:v0.1.0-alphaPia unaweza kuvuta picha yenye lebo ya latest:
docker pull ghcr.io/albert-weasker/niubigeo:latestSakinisha kwa Node.js
Ukitaka kuendesha mradi bila Docker, thibitisha kuwa Node.js 22 au toleo jipya zaidi limesakinishwa. Kisha nakili hazina, unda faili la mazingira, sakinisha vitegemezi, endesha ukaguzi wa kujitegemea na uanzishe seva.
git clone https://github.com/Albert-Weasker/niubigeo.git
cd niubigeo
cp .env.example .env
npm install
npm run self-check
npm run serverOngeza ufunguo wa mtoa huduma kwenye .env kabla ya kujaribu ukaguzi. Bila ufunguo uliosanidiwa, NiubiGEO haiwezi kutoa matokeo halisi ya mwonekano wa AI.
Endesha Ukaguzi Wako wa Kwanza kwenye Kiolesura cha Wavuti
- Ingiza kikoa: Toa kikoa cha kampuni yako au ukurasa muhimu wa bidhaa.
- Kagua matokeo ya ugunduzi: NiubiGEO hutambua chapa, lakabu, kategoria, maneno muhimu na washindani wanaowezekana.
- Thibitisha huluki: Sahihisha taarifa za chapa na tofautisha washindani halisi na majina yasiyohusiana.
- Kagua maswali: Hariri maswali yaliyopendekezwa ya wateja kabla ya ombi lolote kwa mtoa huduma kutumwa.
- Endesha ukaguzi: NiubiGEO huita API ya mtoa huduma aliyechaguliwa na kuchambua majibu yake pamoja na vyanzo vilivyorejeshwa.
- Soma ripoti: Chunguza utambuzi wa chapa, kuonekana kwa washindani, maswali ambayo chapa haikuonekana na ushahidi unaounga mkono.
Ripoti kuu inasisitiza hitimisho fupi na yaliyo wazi. Majibu kamili ya AI yamekunjwa kwa chaguo-msingi, hivyo unaweza kuyapanua tu unapohitaji kuthibitisha ushahidi.
Endesha Ukaguzi kutoka kwenye Mstari wa Amri
CLI ni muhimu kwa majaribio ya ndani yanayoweza kurudiwa na mtiririko wa kazi unaoendeshwa kwa hati. Mfano ufuatao hukagua example.com kupitia OpenRouter, hutumia modeli mbili, na huzalisha vidokezo vinane:
npm run audit -- \
--domain example.com \
--provider openrouter \
--models openai/gpt-4o-mini,perplexity/sonar \
--prompt-count 8Badilisha kikoa, mtoa huduma, na vitambulisho vya modeli kwa thamani zinazofaa ukaguzi wako na vitambulisho vilivyosanidiwa.
Ongeza maneno muhimu, washindani, na maswali maalum
Unaweza kuelekeza ukaguzi kwa maneno muhimu ya kategoria, washindani unaowajua, na maswali ya wateja. Tenganisha maneno muhimu na washindani kwa koma. Tenganisha vidokezo maalum kwa mstari wima.
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?"Kwa chaguo-msingi, ripoti zinazozalishwa huhifadhiwa kwenye saraka ya ndani ya runs/.
Jinsi ya Kutafsiri Ripoti
Kagua utambuzi wa chapa kwanza
Angalia ikiwa modeli inatambua bidhaa kwa usahihi, kategoria inayoipa, na uwezo muhimu inaouacha. Utambuzi pekee haumaanishi kuwa modeli inaelewa kwa usahihi nafasi ya chapa.
Kagua washindani waliothibitishwa
Wazingatie washindani wanaojitokeza mara kwa mara katika maswali ya mapendekezo au mbadala. NiubiGEO hutenganisha washindani waliothibitishwa na chapa zinazoweza kuwa na uhusiano, hivyo kukusaidia kuepuka kuichukulia kila kampuni iliyotajwa kama mpinzani wa moja kwa moja.
Tafuta maswali ambayo chapa yako haipo
Pengo muhimu la mwonekano ni swali linalohusiana na mteja ambapo bidhaa shindani zinapendekezwa lakini chapa yako haipo. Mapengo haya yanaweza kuonyesha mahali ambapo AI haina taarifa kuhusu nafasi ya chapa yako au haihusishi bidhaa yako na matumizi fulani.
Kagua vyanzo na majibu ya awali
Fungua ushahidi unaounga mkono hitimisho muhimu. Bainisha ikiwa jibu linategemea tovuti yako rasmi, mijadala ya jumuiya, au kurasa za wahusika wengine. Marejeo yanaishia kwenye vyanzo vilivyorudishwa na mtoa huduma au vilivyopo waziwazi kwenye jibu la AI.
Vidokezo vya Juu vya Ukaguzi Bora
Tumia maswali yanayoakisi nia ya mnunuzi
Vidokezo vya jumla huenda visitambue mapengo muhimu zaidi ya ushindani. Ongeza maswali ambayo wateja huuliza kwa hakika, kama vile mapendekezo ya kategoria, mbadala, ulinganisho, na maombi yanayohusiana na matumizi mahususi. Kagua kila mara maswali yaliyotengenezwa kabla ya kuanza miito kwa mtoa huduma.
Jaribu zaidi ya modeli au mtoa huduma mmoja
Modeli tofauti zinaweza kutambua chapa, kupendekeza washindani, na kurudisha vyanzo kwa njia tofauti. Ukaguzi wa watoa huduma wengi hukusaidia kuchunguza tofauti hizi, lakini matokeo hayapaswi kuchukuliwa kuwa sawa moja kwa moja na miingiliano ya bidhaa kwa watumiaji.
Weka masharti ya ukaguzi sawa
Matokeo ya AI yanaweza kubadilika kwa nasibu, hivyo uendeshaji mmoja si cheo cha kudumu. Unapotathmini mabadiliko, hifadhi kikoa, maswali, mtoa huduma, modeli, lugha, na masharti mengine ya ukaguzi kwa ukaribu iwezekanavyo. Ulinganisho rasmi wa ripoti chini ya masharti yanayofanana umeorodheshwa kama kipengele kilichopangwa, badala ya uwezo uliopo sasa.
Chagua lugha sahihi
NiubiGEO inasaidia Kiingereza na Kichina Kilichorahisishwa. Lugha iliyochaguliwa huathiri kiolesura, maswali ya ufuatiliaji yanayotengenezwa, vidokezo vya watoa huduma, uchanganuzi wa chapa na washindani, pamoja na ripoti ya mwisho. Tumia lugha inayolingana na hadhira ambayo ungependa kuchunguza uzoefu wake.
Elewa mipaka ya matokeo ya API
Majibu ya API ya mtoa huduma yanaweza kutofautiana na majibu yanayoonyeshwa katika programu za wavuti za watumiaji. Community Edition haiigizi watumiaji wa maeneo mbalimbali wala miingiliano ya wavuti ya watumiaji. Majaribio ya binadamu, picha za skrini, ukaguzi wa maeneo mbalimbali, na vifurushi kamili vya ushahidi wa watumiaji ni sehemu ya huduma tofauti inayodhibitiwa iliyoelezwa na mradi.
Linda vitambulisho na data ya ripoti
Usiwahi kuweka .env, funguo za watoa huduma, vidokezo vya faragha, ripoti za wateja, au faili nyeti kutoka runs/ kwenye udhibiti wa msimbo. Mradi unapendekeza kuripoti masuala ya usalama kwa faragha kupitia sera yake ya usalama.
Hali ya Sasa ya Mradi
Kwa sasa NiubiGEO iko kwenye v0.1.0-alpha. Mtiririko wake mkuu wa ukaguzi unafanya kazi, lakini miingiliano, sheria za ripoti, na miundo ya data inaweza kubadilika.
Uwezo wa sasa unajumuisha ukaguzi wa watoa huduma wengi, uthibitishaji wa maswali kabla ya ukaguzi, ugunduzi wa chapa na washindani, uchujaji wa vyanzo, ripoti zinazoweza kufuatiliwa, na usaidizi wa lugha mbili. Ufuatiliaji uliopangwa, ulinganisho wa ripoti, vifurushi vya uhamishaji wa ripoti, SDK ya programu-jalizi za watoa huduma, na watoa huduma wa ziada vimepangwa badala ya kupatikana kwa sasa.
Wakati wa Kutumia NiubiGEO
NiubiGEO inafaa sana unapohitaji ukaguzi wa chanzo huria, udhibiti wa modeli na maswali, uendeshaji unaojihifadhi mwenyewe, na ufikiaji wa moja kwa moja wa ushahidi nyuma ya kila hitimisho. Majukwaa ya kibiashara yanaweza kufaa zaidi unapohitaji miundombinu inayosimamiwa, seti za data za umiliki, ripoti zilizopangwa, mtiririko wa kazi wa timu uliokomaa, au miunganisho mipana zaidi ya uuzaji.
Hitimisho
NiubiGEO hutoa njia yenye uwazi ya kuchunguza ikiwa mifumo ya AI inaijua bidhaa yako, jinsi inavyoielezea, ni washindani gani inapendekeza, na ni vyanzo gani vinavyoathiri majibu yake. Anza kwa Docker au Node.js, unganisha mtoa huduma mmoja anayeungwa mkono, kagua kwa makini maswali yako, na tumia viungo vya ushahidi katika ripoti kubadilisha matokeo ya mwonekano wa AI kuwa uchunguzi unaoweza kuthibitishwa.
Kwa masasisho, msimbo wa chanzo, na maelekezo ya kuchangia, tembelea hifadhi ya NiubiGEO kwenye GitHub.
