설정 가이드
첫 번째 키부터 차트까지, 하나의 API 호출을 신뢰할 수 있는 시계열 데이터로 전환하는 단계별 설정 가이드입니다.
/auth/google.php에서 Google 계정으로 로그인하세요. 계정 생성 시 $100(1,000,000 크레딧)이 제공되며, sk_로 시작하는 키를 복사하세요.
열: domain, dr, ref_domains, pulled_on, source. 도메인과 pulled_on을 기본 키로 설정하여 매월 데이터가 중복 삽입되지 않도록 합니다.
매월 5일에 실행하세요. 인덱스는 약 한 달 주기로 갱신되므로, 그 이상 자주 실행해도 정보량은 증가하지 않습니다.
JSON을 읽고 ok가 true인지 확인한 후, 수집 날짜와 함께 각 행을 삽입합니다.
전월 대비 변화량을 계산하고, 3 포인트 이상 변동된 항목에 플래그를 지정합니다. 그 이하의 변동은 대부분 노이즈입니다.
도메인별 한 줄로 표시하고, 자사 도메인은 굵은 색상으로, 경쟁사는 회색으로 표시합니다.
크론 설정: 매월 5일 06:00에 실행. 실행당 비용은 크레딧 1개입니다.
0 6 5 * * curl -s -X POST "https://rankwiser.app/api.php?action=bulk_dr&key=$RW_KEY" \
-d "domains=$(paste -sd, /etc/rw/domains.txt)" > /var/rw/dr_$(date +%F).json도메인 DR은 겉보기에는 숫자이지만 본질적으로는 카운트입니다. 별개 사이트에서 도메인으로 연결되는 링크가 늘어날수록 수치는 상승하며, 로그 스케일 때문에 새로운 포인트를 얻는 것이 점점 더 어려워집니다. 이 내용은 차트 메모에 반드시 기록하세요.
좋은 차트는 도메인 세트당 하나의 추세 질문에만 답합니다. 경쟁사 3곳에 추격을 가하고 있는지, 파트너 사이트가 성장하고 있는지, 캠페인이 효과를 보았는지 등입니다. 나쁜 차트는 트래픽이나 수익을 섞어 넣으며 데이터가 담지 못할 인과 관계를 유도합니다.
원점수(referring-domain count)도 함께 저장하세요. 점수가 1 포인트 변했을 때, 그것이 40개의 새 도메인 때문인지 4,000개의 새 도메인 때문인지 알 수 있으며, 이는 우려할 만한 사항인지 판단하는 데 도움이 됩니다.
스냅샷 테이블은 메모리입니다. 1년 후 차트를 설명하는 데 필요한 데이터만 담아야 하며, 잘못된 해석을 유도하는 데이터는 담지 않아야 합니다. 추세 질문에 답할 수 있는 최소한의 열로 시작하세요. 회의에서 요구할 때만 하나씩 추가하세요.
몇몇 열은 첫날부터 그 존재 가치를 증명합니다. 생각보다 적은 수의 열이 필요합니다. 도메인, 점수, 원점수, 수집 날짜, 소스 이름은 대부분의 질문에 답할 수 있습니다. 트래픽 열은 유용해 보이지만 다른 소스와 다른 시점의 데이터이므로 별도의 테이블에 속합니다.
나머지 데이터로 재계산할 수 있는 항목은 제외하세요. 전월 대비 변화량은 단순 뺄셈이므로, 동일한 사실의 네 번째 복사본으로 저장하기보다는 뷰(view)로 관리하세요.
열 목록을 차트 메모에도 기록하세요. 1년 후 차트를 여는 독자가 각 숫자의 출처와 이를 채운 수집 시점을 확인할 수 있어야 합니다.
도메인과 수집 날짜를 기본 키로 설정하는 것은 중복을 방지하는 것 이상입니다. 이 키는 각 행이 어느 수집 작업에서 비롯되었는지 알려주며, 타임아웃 후 재실행 시 특히 중요합니다. 같은 도메인의 같은 달 데이터가 두 개 이상 존재하는 것은 불가능해야 하며, 스키마가 이를 명시해야 합니다.
소스는 rankwiser_bulk_dr과 같은 고정 라벨로 기록하세요. 자유 텍스트 메모가 아닙니다. 이 라벨로 필터링하면 나중에 로드하는 다른 점수 데이터와 구분됩니다. 라벨 목록은 짧게 유지하고 테이블 옆에 기록해 두세요.
| 추적 도메인 수 | 월간 API 호출 수 | 크레딧 | 달러 |
|---|---|---|---|
| 50 | 1 | 1 | $0.0001 |
| 500 | 1 | 1 | $0.0001 |
| 5,000 | 3 | 3 | $0.0003 |
401은 키가 없거나 잘못되었음을 의미합니다. 402는 크레딧이 부족함을 의미하므로 계정 페이지에서 USDT로 충전하세요. ok가 true가 아닌 모든 응답에 대해 알림을 설정하고, 차트에 0을 입력하지 마세요.
잘 아는 사이트, 경쟁사, 소규모 사이트 하나씩을 선택하세요. 세 개면 응답의 형태를 파악하기에 충분합니다.
세 도메인에 대해 bulk_dr을 호출하고, 파싱된 행뿐만 아니라 원본 응답도 저장하세요.
ok가 true인지 확인하고 _credits 값을 읽으세요. 호출 비용은 크레딧 1개여야 하며, 잔액은 그만큼 감소해야 합니다.
이 사이트의 무료 조회 기능을 사용해 도메인 중 하나를 확인하세요. 점수가 파서가 저장한 값과 일치하면 파서가 정확합니다.
실패한 수집 이력을 저장할 두 번째 테이블을 유지하세요. HTTP 상태, 시간, 응답 본문이 포함된 행은 차트의 침묵하는 공백보다 낫습니다. ok가 true가 아닌 모든 경우에 알림을 설정하세요.
도메인 목록을 버전 관리 시스템에 고정하세요. 짧은 변경 이력이 도움이 됩니다. 누군가 경쟁사를 추가하면 변경 이력에서 누가 언제 추가했는지 알 수 있으며, 차트에 메모가 추가됩니다. 그렇지 않으면 해당 도메인의 선이 갑자기 나타나며 사람들은 왜 3월에 시작했는지 묻습니다.
소스 변경에 대한 계획도 세우세요. 나중에 Ahrefs나 Moz 점수를 추가한다면, Ahrefs와 Majestic 비교에서 논의한 대로 테이블에 고유한 소스 값을 부여하세요.
차트를 신뢰하기 전에, 차트를 채운 작업을 먼저 확인하세요. 그 다음 차트를 보세요. 정상적인 실행은 ok가 true이고, 요청한 도메인마다 한 행씩 반환하며, 잔액이 예상 금액만큼 감소합니다. 그 외의 모든 경우는 선을 그리는 이유가 아니라 응답을 읽어봐야 하는 이유입니다.
변동한 행의 수를 세세요. 큰 비율의 행이 3 포인트 이상 이동했다면 인덱스를 탓하기 전에 도메인 목록을 확인하세요. 갑작스러운 이동 폭 증가는 보통 웹 환경의 변화가 아니라 목록의 변경을 의미합니다.
목록과 일치하는 행 수는 최소한의 기준입니다. 행 수가 적다면 파일에서 테이블로 가는 과정에서 도메인이 누락된 것입니다. 다음 실행 전에 이를 찾아야 합니다.
변동이 거의 없는 달이 안정성의 증거는 아닙니다. 인덱스는 약 한 달 주기로 갱신되므로, 평탄한 행은 단순히 아직 업데이트되지 않았을 수 있습니다. 조용한 달을 수집 날짜와 함께 읽으세요. 차트는 여전히 캘린더를 따릅니다.
공유 받은함으로 가는 알림은 한 달 안에 무시됩니다. 이 역할을 담당할 사람 한 명과, 해당 인원이 부재 중일 때 대체할 두 번째 사람을 지정하세요. 알림에는 도메인 목록, HTTP 상태, 시간이 명시되어야 하므로, 독자는 스크립트를 열지 않고도 대응할 수 있습니다.
목록이나 일정을 변경한다면, 한 주 동안 이전 버전과 새 버전을 병렬로 실행하세요. 행이 일치한다면 변경 사항이 다른 부분에 영향을 미치지 않았다는 뜻입니다. 설명할 수 없는 차이가 있다면 외관이 작더라도 롤백해야 합니다.
여기서 속도가 필요한 것은 아닙니다. 대용량 목록이라도 월간 실행은 몇 번의 요청에 불과하며, 각 응답은 하나의 JSON 문서로 도착합니다. 스케줄러가 실패 시 재시도한다면, 도메인과 수집 날짜의 기본 키가 이미 제공한 대로 재시도를 멱등하게(idempotent) 만드세요.
비용이 저렴하다고 해서 매일 실행하려는 유혹을 참으세요. 그러지 마세요. 인덱스는 약 한 달 주기로 갱신됩니다. 매일 수집하면 몇 주 동안 동일한 행이 반환되며, 차트는 안정성처럼 보이지만 실제로는 크롤링 캘린더만 반영하는 평탄한 선으로 채워집니다. Majestic 대체 레시피를 읽어보세요. 앵커(anchor)와 교차점(intersection) 등 예약할 가치가 있는 다른 수집 방법이 있습니다.
월간 작업은 이를 만든 사람보다 오래갑니다. 6개월 후 누군가가 크론 진입을 열어보고 목록이 파일에 저장된 이유를 궁금해할 것입니다. 짧은 메모를 작성하세요. 스크립트 상단에 목적, 일정, 크레딧 비용을 적어두세요. 그 메모는 미팅 한 번보다 저렴합니다.
분기마다 도메인 목록을 검토하세요. 더 이상 중요하지 않은 항목은 제거하고, 의사 결정에 실제로 영향을 미치는 경쟁사를 추가하세요. 각 변경 사항은 날짜와 함께 버전 관리 시스템에 기록되므로, 차트는 변경 사항을 숨기지 않고 보여줄 수 있습니다.
예산도 검토의 일부입니다. 월 1 크레딧. 비용은 미미합니다. 차트 생성 당일 잔액을 확인하고, 다음 충전 날짜를 같은 메모에 기록하세요.
작업이 몇 달간 실행된 후면 네 가지 질문이 자주 발생합니다. 각 답변은 설정 메모에 기록할 수 있는 규칙입니다.
데이터는 월간 캘린더에 따라 변경되므로, 매일 수집하면 같은 행이 몇 주 동안 반복됩니다. 비용은 작지만, 차트는 안정성처럼 보이는 평탄한 선으로 채워집니다. 이사회 보고용 차트라면 이사회 러닝북 각주가 필요합니다.
이력을 유지하고 도메인을 '제거됨'으로 표시한 후 수집을 중단하세요. 누락된 선은 데이터 공백처럼 보이므로, 차트 옆에 이유를 기록하세요.
네, 날짜를 하나 정하고 그 날짜를 고수한다면 가능합니다. 핵심은 일정한 리듬입니다. 매월 날짜를 며칠씩 옮기면 추세를 읽기 어려워집니다.
작업을 중단하고 계정 페이지에서 USDT로 충전한 후, 실패한 요청만 다시 실행하세요. 실패한 응답을 로그에 남겨 차트의 공백에 대한 서면 설명을 제공하세요.
