Tämä opas vie sinut asennuksesta ensimmäiseen kilpailija-analyysiin. Seuraa vaiheita järjestyksessä tai hyppää suoraan tarvitsemaasi kohtaan.
Ennen aloitusta
Varmista, että seuraavat asiat ovat kunnossa ennen kuin aloitat SEO Intelin asennuksen.
SEO Intel käyttää Noden uusimpia ominaisuuksia. Lataa nodejs.org:sta
AI-ekstraktointiin ja paikalliseen analyysiin. Lataa ollama.com:sta
Suositellaan AI-mallien ajamiseen. Crawlaus toimii vähemmälläkin muistilla.
Toimii kaikilla käyttöjärjestelmillä, joissa Node.js on saatavilla.
Asenna SEO Intel globaalisti npm:stä. Tämä antaa käyttöösi seo-intel -komennon kaikkialla terminaalissa.
Vaihtoehtoinen asennustapa ClawHubin kautta:
Tarkista asennus:
nvm use 22
Käynnistä ohjattu asennus, joka avautuu selaimeen. Wizard opastaa kaiken konfiguroinnin.
Setup wizard avaa web-pohjaisen käyttöliittymän, jossa konfiguroit:
.env-tiedostoon. Voit muokata niitä myös käsin.
Solo-käyttäjille. Osta lisenssi ukkometa.fi/seo-intel -sivulta tai Lemon Squeezystä.
Lisää avain .env-tiedostoon:
Tai syötä avain suoraan setup wizardissa (vaihe 2). Tarkista lisenssin tila:
SEO Intel käyttää paikallista Ollamaa sivusisällön ekstraktointiin. Asenna Ollama ja vedä suositeltu malli.
Ollaman asennus:
Suositellun mallin lataus:
| Malli | Koko | Nopeus | Käyttö |
|---|---|---|---|
gemma4:e2b | 6.7 GB | ~47 t/s | Budjetti / nopea |
gemma4:e4b | 8.9 GB | ~23 t/s | Tasapainoinen (oletus) |
qwen3.5:4b | 2.8 GB | ~60 t/s | Vähän RAM-muistia |
qwen3.5:9b | 6.0 GB | ~30 t/s | Vaihtoehtoinen tasapainoinen |
.env -asetukset Ollamalle:
| OLLAMA_URL | Ollaman osoite (oletus: http://localhost:11434) |
| OLLAMA_MODEL | Käytettävä malli (oletus: gemma4:e4b) |
| OLLAMA_CTX | Konteksti-ikkunan koko (oletus: 8192) |
Pilvi-AI analyysiin (valinnainen):
seo-intel analyze -komento käyttää pilvi-AI:ta syvempään kilpailija-analyysiin. Lisää jokin seuraavista:
| GEMINI_API_KEY | Google Gemini — edullisin vaihtoehto |
| ANTHROPIC_API_KEY | Anthropic Claude — paras laatu |
| OPENAI_API_KEY | OpenAI GPT — yleinen vaihtoehto |
Yhdistä Google Search Console saadaksesi hakukonedataa suoraan analyysiin. Tämä on valinnainen vaihe.
1. Luo OAuth-tunnukset:
Mene Google Cloud Consoleen, luo uusi OAuth 2.0 -tunniste ja lisää redirect URI http://localhost:3000/callback.
2. Lisää .env-tiedostoon:
| GOOGLE_CLIENT_ID | OAuth Client ID |
| GOOGLE_CLIENT_SECRET | OAuth Client Secret |
3. Autentikoidu:
Selain avautuu automaattisesti Google-kirjautumiseen. Hyväksy käyttöoikeudet, ja token tallentuu paikallisesti.
Kaikki on nyt valmiina. Aja ensimmäinen crawlaus ja katso tulokset dashboardissa.
Crawlaa kaikki konfiguroidut domainit:
Stealth-tila hankalille sivustoille:
AI-ekstraktointi (lukee tietokannasta, ei tarvitse verkkoa):
Kilpailija-analyysi pilvi-AI:lla:
Avaa dashboard selaimeen:
Pikaopas
Kaikki SEO Intelin komennot yhdessä taulukossa.
| Komento | Kuvaus |
|---|---|
| seo-intel setup | Avaa ohjatun asennuksen selaimeen |
| seo-intel crawl | Crawlaa kaikki konfiguroidut domainit |
| seo-intel crawl --stealth | Crawlaa stealth-tilassa (Playwright) |
| seo-intel extract | AI-ekstraktointi paikallisella Ollamalla |
| seo-intel analyze | Kilpailija-analyysi pilvi-AI:lla |
| seo-intel serve | Käynnistä dashboard-palvelin |
| seo-intel status | Näytä projektin ja lisenssin tila |
| seo-intel gsc-auth | Google Search Console -autentikointi |
| seo-intel templates | Näytä URL-patternien klusterointi |
| seo-intel --version | Näytä asennettu versio |
| seo-intel --help | Näytä kaikki komennot ja liput |
Yleiset liput:
| Lippu | Kuvaus |
|---|---|
| --stealth | Käytä Playwright-pohjaista stealth-crawlausta |
| --depth N | Crawlaussyvyys (oletus: konfigurointiarvo) |
| --concurrency N | Samanaikaisten yhteyksien määrä |
| --domain example.com | Crawlaa vain tietty domain |
| --verbose | Näytä yksityiskohtaiset lokit |
Ongelmia?
Yleisimmät ongelmat ja niiden ratkaisut.
Ollama ei ole käynnissä. Avaa uusi terminaali-ikkuna ja aja ollama serve. macOS:ssa Ollama-sovelluksen käynnistäminen riittää.
SEO Intel vaatii Node.js 22.5+. Tarkista versiosi: node --version. Päivitä nodejs.org:sta tai käytä nvm:ää: nvm install 22.
Toinen SEO Intel -instanssi (tai muu prosessi) käyttää jo samaa porttia. Sulje edellinen prosessi tai käynnistä dashboard uudelleen. SEO Intel yrittää automaattisesti toipua tästä.
Kokeile kevyempää mallia: ollama pull gemma4:e2b ja aseta OLLAMA_MODEL=gemma4:e2b .env-tiedostossa. Kevyempi malli on nopeampi (~47 t/s) mutta hieman vähemmän tarkka.
Tarkista lisenssiavain: seo-intel status. Varmista, että SEO_INTEL_LICENSE on oikein .env-tiedostossa. Osta uusi lisenssi tarvittaessa.
Sivut on crawlattu ennen versiota 1.1.6, joka alkoi tallentaa body_text. Crawlaa domainit uudelleen: seo-intel crawl.
Usein kysytyt kysymykset
Vastaukset yleisimpiin kysymyksiin SEO Intelin asennuksesta ja käytöstä.
Crawlaus ja raakadata ovat täysin ilmaisia — ei aikarajaa eikä sivumäärän rajoitusta. AI-ekstraktointi, kilpailija-analyysi ja dashboard vaativat Solo-lisenssin (9 €/kk). Voit testata crawlausta rajattomasti ennen lisenssin ostamista. Lisenssiavain syötetään setup wizardissa (seo-intel setup).
Ei. SEO Intel toimii kokonaan omalla koneellasi. Crawlaus, AI-ekstraktointi ja dashboard ajetaan paikallisesti. Ainoa valinnainen verkkoyhteys on pilvi-AI (Gemini, Claude, GPT) kilpailija-analyysiin. Kaikki konfigurointi — domainit, mallit, API-avaimet — hoituu setup wizardissa selaimessa.
Oletussuositus on gemma4:e4b — hyvä tasapaino nopeuden ja laadun välillä. Jos RAM on rajallinen (alle 8 GB), käytä qwen3.5:4b. Nopeampaan ajoon kokeile gemma4:e2b. Mallin voi vaihtaa milloin tahansa setup wizardissa (seo-intel setup) tai manuaalisesti .env-tiedostossa.
Kyllä. SEO Intel toimii kaikissa käyttöjärjestelmissä, joissa Node.js 22.5+ on saatavilla: macOS, Windows ja Linux. Ollama on myös saatavilla kaikille alustoille.
Ilmaistasolla ei ole sivustomäärän rajoitusta crawlaukseen. Solo-lisenssillä voit analysoida oman sivustosi ja jopa viisi kilpailijaa per projekti. Projekteja voi olla rajattomasti.
Ahrefs ja Semrush seuraavat hakutulossivujen historiaa — ne kertovat mitä tapahtui. SEO Intel analysoi sisällön rakennetta, entiteettejä ja AI-siteerattavuutta ennustaakseen puutteita ennen kuin ne näkyvät hakutuloksissa. Se on ennakoiva työkalu, ei reaktiivinen.
Kyllä, osittain. Crawlaus, AEO-pisteytys ja dashboard toimivat ilman Ollamaa. AI-ekstraktointi (seo-intel extract) vaatii paikallisen mallin — Ollama on oletuspalvelin, ja LM Studio -tuki on tulossa. Kilpailija-analyysi (seo-intel analyze) käyttää pilvi-AI:ta, ei Ollamaa.
Ei. Kaikki crawlattu data, ekstraktoidut tulokset ja analyysit tallentuvat paikalliseen SQLite-tietokantaan omalle koneellesi. SEO Intel ei lähetä dataa ulkoisille palvelimille. Pilvi-AI-analyysi lähettää tiivistettyä dataa valitsemallesi AI-palveluntarjoajalle.
Yleisiä kysymyksiä tuotteesta? Katso SEO Intel -tuotesivun UKK.
Asenna SEO Intel ja aja ensimmäinen kilpailija-analyysi muutamassa minuutissa.