Konfiguration av domain rating-verktyg för ett arkiv och ett cron-jobb
Ett arbetsflöde som ingen behöver komma ihåg slår ett där alla menar att de ska göra det. Sex steg tar dig från ett tomt arkiv till ett månatligt jobb som loggar sina egna kostnader.
ASEOTools redaktionella team ·
Sex steg, cirka en timme
01
Logga in och kopiera nyckeln
Använd Google-inloggningen på /auth/google.php. Dashboarden på /account.php innehåller din nyckel, som börjar med sk_ och levereras med $100 i kredit.
02
Gör ett gratis testanrop
Kör översiktsåtgärden utan nyckel mot din egen domän. Om du får JSON med ok satt till true fungerar nätverksvägen.
03
Bygg domänlistan
En kolumn i ett arkiv, en domän per rad, inget https och inga sökvägar. Upp till 2 000 rader går in i ett enda bulk_dr-anrop.
04
Anropa bulk_dr från arkivet eller ett skript
Skicka listan som ett kommaseparerat GET-värde eller som en POST-body. Svara i en andra flik med en datumkolumn.
05
Schemalägg det månatligen
Kör jobbet några dagar efter den första i månaden, när den månatliga indexuppdateringen har landat. En cron-rad räcker. Kontrollera utdata från den första månaden manuellt mot tre domäner du känner väl.
06
Logga kredit och avisera vid låg balans
Varje autentiserat svar innehåller _credits med kostnaden och återstående balans. Skriv båda till en loggrad och mejla dig själv under en tröskel du väljer.
Bitarna, klara att klistra in
Byt ut din egen nyckel och filnamn.
bash
# crontab: 06:00 on the 4th of each month
0 6 4 * * /usr/bin/curl -s -X POST \
-H "Authorization: Bearer sk_live_..." \
-d "domains=$(paste -sd, domains.txt)" \
"https://aseotools.com/api.php?action=bulk_dr" >> dr_log.jsonl
Håll nyckeln utanför arkivet
Placera nyckeln i Apps Script-properties, en miljövariabel eller ditt automatiseringsverktygs behörighetslager. Alla som har redigeringsåtkomst till ett arkiv kan läsa en nyckel skriven i en cell, och en läckt nyckel spenderar din kredit.
Var denna konfiguration misslyckas
Tystnad är det vanliga misslyckandet. Ett cron-jobb som felar ser ut exakt lika som ett som lyckats.
Kontrollera HTTP-koden. En 401 betyder att nyckeln saknas eller är fel, och en 402 betyder att krediten tog slut, så avisera vid antingen och åtgärda det innan nästa månads rapport är förfallen.
Kom ihåg också att paginering är begränsad till 50 000 rader djupt, och att bulk_dr tar upp till 2 000 domäner per anrop. Längre listor behöver chunking, vilket är en extra loop och kostar en kredit per chunk.
Testa manuellt först. Kör cron-raden i en terminal, läs loggfilen och kontrollera att balansen sjönk med exakt den kostnad du förväntade dig. Se sedan hur siffrorna jämförs med ett suite-plan och bestäm hur ofta du ska köra det.
Versionera din domänlista. Förvara filen i ett repository eller en delad mapp med historik, så att när ett nummer ändras i mars kan du se om listan ändrades också. Lägg till en notiskolumn för domäner du lade till medvetet, som en ny konkurrent eller en kund som loggade in den månaden. Behandla listan som data med en ägare, för den billigaste buggen är den du hittar i en diff.
Att dela upp en lång lista i chunks
Långa listor är där en snygg konfiguration möter sin gräns. Ett bulk-anrop tar upp till 2 000 domäner, så en lista på 5 000 behöver tre anrop, och splittringen måste ske innan det första anropet skickas iväg.
Dela upp efter en stabil regel, som den sorterade ordningen av domänskolumnen. På så sätt hamnar samma domän i samma chunk varje månad, och jämförelsen håller.
Listor över 2 000 rader
Skriv varje chunk till arkivet som sitt eget block, med chunknumret i den första kolumnen. En misslyckad chunk är då lätt att hitta.
Varje chunk kostar en kredit, så en lista på 5 000 rader blir 3 kredit per körning, vilket är $0.0003. Ett domain rating-verktyg är bara lika användbart som listan det läser, så håll den listan städat.
Om listan växer bortom 5 000 rader, överväg arkivets layout. En flik per månad håller varje körning läsbar när raderna hopar sig.
Köra om en misslyckad chunk
Om chunk två returnerar ett fel, kör bara om chunk två. Att köra om hela listan skulle spendera kredit på rader som redan kommit tillbaka.
Logga chunknumret med statuskoden, så att omkörningen blir en rad i loggen, inte en jakt genom arkivet.
Att hålla chunkkartan stabil
Om domänlistan ändrar ordning, flyttas chunkarna, och en månadsjämförelse bryts. Sortera listan innan du delar upp den, varje gång.
Lagra chunkkartan bredvid listan.
Ett enkelt test: välj valfri chunk och räkna om dess rader mot listan. En missmatch betyder att kartan har flyttat sig, och det är billigare att hitta i arkivet än i rapporten.
Vad du ska bekräfta innan det första schemalagda körningen
Testa en chunk manuellt och läs hela svaret
Bekräfta att balansen sjönk med exakt de kredit du förväntade dig
Kontrollera statuskoden för varje chunk, inte bara den första
Jämför tre domäner du känner väl med siffror du redan litar på
Sätt en sökväg för loggfilen och bestäm vem som läser den varje månad
Skriv ägarens namn högst upp i arkivet
Vad en användbar månatlig loggrad innehåller
En logg som bara säger ok är inte mycket av en logg. Varje körning bör skriva en rad som en trött person kan läsa på tio sekunder: datumet, chunken, statusen, krediterna spenderade och balansen efter anropet.
Hypotetiskt: en rad som visar chunk fyra, status 200, en kredit spenderad och balansen kvar efter anropet svarar på de flesta frågor en månad senare utan att öppna svaret.
Fält värdiga att logga
Logga datumet, listnamnet, chunknumret, statuskoden, debiterade kredit och balansen efter anropet. De sex fälten täcker de flesta frågor en månad senare.
Lägg till en fritekstsnot bara när en person ändrade något manuellt.
Aviseringar som inte ropar varg
Avisera omedelbart vid en 401 eller en 402, eftersom båda betyder att jobbet inte kan utföra sitt arbete. En varning vid låg balans bör använda den tröskel du valde, så att den avfärdas en gång och säger vad som ska göras härnäst.
Skicka en avisering per körning, inte en per rad, eller blir inkorgen brus.
Konfigurationsfrågor
Fungerar ett Google Sheet som klient?
Ja. API:et är vanligt REST med öppen CORS och JSON-svar, så Apps Script eller ett IMPORTDATA-liknande anrop kan nå det. Håll nyckeln i script-properties snarare än i en cell som samarbetspartners kan läsa.
Kan jag använda detta med n8n eller Make?
Ja, via en vanlig HTTP-request-node. Skicka nyckeln som en Authorization Bearer-header, parsade JSON-svaret och skriv _credits-fältet till din logg så att du kan se utgift per körning.
Varför visar loggen en högre kostnad än jag förväntade mig för detta domain rating-verktyg?
Räkna anropen, inte bara liststorleken. En chunk per körning, en retry eller ett testanrop lägger till sin kostnad, och _credits-fältet i varje svar ger exakt siffra för det anropet.
Ska nyckeln sitta i cron-raden själv?
Det är enklare, men alla som kan läsa crontab kan läsa nyckeln. Ladda den från en fil med begränsade behörigheter eller från en miljövariabel inställd för jobbet, och håll den utanför delade loggar.
Vem lägger märke när jobbet går sönder
Ett månatligt jobb körs utan att någon tittar på det. Det är poängen med att automatisera det, och det är också varför ett fel kan ligga obemärkt i veckor.
Namnge personen som läser loggen och personen som fixar jobbet. Två namn slår ett. Semester händer. Runbooken förklarar hur man väljer listan från början.
Tid spenderad på konfiguration versus underhåll
Den första körningen tar mest av timmen, eftersom nyckeln, arkivet och testanropet alla behöver uppmärksamhet. Därefter bör rutinen behöva en blick varje månad, inte en ombyggnad.
Om underhållet ökar är listan vanligtvis orsaken. En lista som ändras varje vecka behöver en ägare, en version och en regel för tillägg.
Att göra ett fel synligt
En saknad rad i utdata är lättare att se än ett tyst fel. Jämför radantalet med längden på listan vid varje körning, och skriv en varning när de skiljer sig åt.
Håll den varningen i samma loggfil, så att personen som läser loggen ser den först.
Schemaläggning kring indexuppdateringen
Indexet uppdateras ungefär en gång i månaden, så en körning den första dagen i månaden kan läsa siffror från den föregående byggnaden. Att köra några dagar senare, som stegen ovan föreslår, ger uppdateringen tid att landa.
Välj samma dag varje månad så att serien förblir jämförbar, och skriv den dagen i en kommentar på cron-raden.
När man ska sluta automatisera
Ett jobb som körs en gång i kvartalet kanske inte motiverar en cron-rad. Ett arkiv och en kalenderpåminnelse kan räcka, och en halvautomatiserad rutin är sämre än en tydlig manuell.
Automatisera när samma steg har körts smidigt i flera cykler i rad.
