セットアップガイド
バックリンクリストを見つけ、月次ウォッチを設定する
10分のセットアップで、誰があなたにリンクしているかの日付付き記録が得られます。トラブルが発生した際、推測するのではなく、2つのファイルのdiffを取ります。
6ステップでセットアップ
APIキーの作成
キーは sk_ で始まります。公開リポジトリから外し、パスワードのように扱ってください。
無料のルックアップを試す
action=overview&q=yourdomain.com は無料で、キーとドメインのスペルを確認できます。
実際のリストを取得する
refdomains、anchors、toppages を実行します。1コールあたり1,000行、各コールで2クレジット必要です。
日付付きで保存する
refdomains-2026-10.json のようなファイル名にします。前月のファイルを上書きしないでください。
Diff
前月の行と比較します。注目すべきは新しいドメインです。
1回の呼び出し、全フィールドの説明
ドメインとキーを置き換えてください。このパターンはすべてのアクションで通用します。
curl "https://darkseo.net/api.php?action=refdomains&q=yourdomain.com&per=1000&page=1&key=sk_live_..." \
-o refdomains-2026-10.jsonパラメータリファレンス
| パラメータ | 意味 | 備考 |
|---|---|---|
| action | 実行するレポート | refdomains、backlinks、anchors、toppages など |
| q | 調査対象のドメイン | スキームなしのドメイン |
| key | APIキー | または Authorization: Bearer sk_... を送信 |
| page | ページ番号 | 深いページネーションは50,000行に制限されます |
| per | 1ページあたりの行数 | 10〜5,000;課金は1コールごと |
| sort, order | ソート列と asc または desc | 最新または最大のものを最初に表示するのに役立ちます |
ファイルの名前付け、保存、比較
バックリンクリストの発見は、ファイルが助けなしで比較できる場合にのみ役立ちます。明確な命名規則と月ごとのフォルダが多くの作業を担います。今すぐルールに10分費やすことで、後で1時間並べ替える手間を省けます。その後、ファイル名を変更しないでください。
すべてのドメインとすべての呼び出しで同じパターンを使用し、単純なソートでファイルを月順に並べます。パターンが混在するとソートが崩れ、それが前月のファイルが上書きされる原因になります。
ソート可能なファイル名
年と月を最初に、次にドメイン、そして呼び出し名(例:2026-10、ドメイン、refdomains)を続けます。ゼロ埋めされた月は正しくソートされ、その順序の名前はログのように読めます。
名前にスペースやアクセント付き文字を避けてください。スクリプトはそれらを正しく処理できず、失敗したコピーが成功したように見える原因になります。
月ごとのフォルダ
各月のフォルダを作成し、各ドメインの3つのファイルをそこにコピーします。月ごとのフォルダにより前月のファイルが手つかずになり、diffは2つのフォルダ間の比較になります。
システムが許可する場合、月が閉鎖されたらフォルダを読み取り専用に設定します。編集不可能な保存ファイルは、はるかに強力な記録となります。
短い変更履歴
ルートフォルダにプレーンテキストのログを保持します。各プルごとに日付、ドメイン、実行したコールを1行で記録します。変更履歴により、数年後に誰が理由を覚えていなくても、シリーズの欠落を説明できます。
各レスポンスからのクレジットコストを同じ行に追加し、ログを請求書としても使用します。
ドメインリストへの変更を理由付きで同じログに記録します。1か月に追加されたドメインはその月の急増を説明し、後の長い検索を節約します。スクリプトがログを読み取れるように、行はプレーンに保ってください。
ミスと修正
| ミス | 症状 | 修正 |
|---|---|---|
| キーの欠落または誤り | HTTP 401 | キーとヘッダーのスペルを確認 |
| 残高が空 | HTTP 402 | アカウントページからUSDT (TRC-20) でチャージ |
ok の読み取りを無視 | 空ファイルが成功として処理 | スクリプトで ok フラグをテストしてから保存 |
| 前月のファイルの上書き | diff が不可能 | ファイル名に月を含める |
| ライブデータを期待 | 新しいリンクが欠落 | インデックスは約月1回更新されます;日次ではなく月次で比較 |
自動化
月の初めにcronエントリを設定するだけで十分です。3つのcurl呼び出しを1つのシェルスクリプトに書き込み、各ファイル名に月を追加し、新しいドメイン数が閾値を超えた場合にのみメールを送信させます。
認証済みレスポンスにはコストと残高を含む _credits が含まれるため、スクリプトは残高が少なくなる前に警告できます。手動で1回テストしてください。その後、メールが届くまで忘れましょう。
チーム向けには、月次プルを例の閾値とペアにすることで、全員が同じルールを読むようにします。
スクリプトを退屈に保ってください。プレーンなcurl、ドメインのループ1つ、月ごとのフォルダ1つ。退屈なスクリプトはスタッフの入れ替わりにも耐えます。
失敗した実行の処理
失敗した実行は、前月のファイルをそのままにし、変更履歴に1行書き込むべきです。よくある罠は部分的なダウンロード:エラーボディを含むファイルは最初はデータのように見えます。移動する前にサイズと ok フラグを確認してください。月フォルダにはチェックなしで何も入れないでください。
連続2回実行が失敗した場合、まずキーとドメインのスペルを確認してください。無料のオーバービュー呼び出しは両方をテストできるため、そこで失敗すれば、問題がセットアップにあるのか有料コールにあるのかがわかります。
予算内でウォッチを維持する
計算が分かればウォッチは安価です。各有料コールは行数に関係なく1回課金され、1コールあたり最大1,000行です。実行するコール数にクレジットコストを掛け、さらにクレジットあたり$0.0001を掛ければ月次請求額が得られます。まずそれを行ってください。
1ドメインで3つのコールを行う場合の計算例。refdomains、anchors、toppages は各2クレジット、合計6クレジットで、月次で$0.0006になります。
月次請求額の推定
新規参入者用に1クレジットの bulk_dr コールを追加すると、合計はさらに1クレジット増えます。閾値ページの表は10サイトの場合を計算しているので、リストが増えるにつれて数字がどのように増えるかを確認できます。
見積もりをプルと同じログに保持してください。見積もりが最初に記録されていれば、請求額が増加していることを説明するのは容易です。
残高が尽きる前に停止する
認証済みレスポンスにはコストと残高が含まれます。スクリプトでそれを読み取り、残高を来月の見積もりと比較し、余裕が少なくなったら警告してください。ok が false のレスポンスは、ファイルが保存される前に実行を停止すべきです。
HTTP 402 は残底が尽きたことを意味します。アカウントページからUSDT (TRC-20) でチャージし、月をスキップするのではなく、その月のコールを再実行してください。
月次ループ
スケッチであり、プロダクトではありません。月名を含むファイルでドメインごとに3つのレポートを保存します。リストとキーを調整してください。
#!/bin/bash
M=$(date +%Y-%m)
for D in yourdomain.com second-site.org; do
for A in refdomains anchors toppages; do
curl -s "https://darkseo.net/api.php?action=$A&q=$D&per=1000&key=$DARKSEO_KEY" -o "$D-$A-$M.json"
done
doneファイルの処理方法
前月と今月の refdomains ファイルを並べて開き、新しい方にのみあるドメインをリストアップします。そのリストが今月の読み取り対象です。
リストを bulk_dr に通してクイック品質スコアを取得し、フレーズが増加していないか anchors ファイルを確認し、認識しないURLがないか top pages を読みます。すべてが普通なら、ログに1行書き込んでタブを閉じます。
何か変だと感じたら、ランブック と disavow判断表 を開いてください。月次プルは1セント未満のコストなので、真のコストはあなたの注意力です。
月次メモの作成
各月の終わりに短いメモを書きます。ドメイン名、新規ドメイン数、最大のアンカーシェア、決定を記載します。4行で十分です。その日に書かれたメモは、後で書かれた長いメモよりも価値があります。
メモはファイルの中ではなく、ファイルの隣に保持してください。将来の読者は、判断とその根拠となった数字を1か所で発見できるべきです。その読者は、月の記憶がない1年後のあなたかもしれません。
月次ウォッチに関する質問
これを実行するには有料プランが必要ですか?
サブスクリプションも月次の最低額もありません。サービスは前払いクレジット制です。新規アカウントにはカード不要で$100の無料クレジットが付与されます。無料のルックアップは無料なので、有料リストを取得する前にセットアップをテストできます。
なぜ毎日スクリプトを実行しないのですか?
インデックスは約月1回更新されるため、毎日ジョブを実行すると同じ画像を繰り返しダウンロードすることになります。日次実行は新しい情報なしにクレジットを消費します。このデータには月次が適切なリズムです。
新しいファイルが大幅に大きい場合どうすればよいですか?
ベースラインに対して行数を確認し、diff で新規参入者を開いてください。ファイルが大きいのは、実際のスパイクまたは行制限の変更によるものです。後者の原因をまず除外してください。それがより安価なチェックだからです。
1つのスクリプトで複数のドメインを監視できますか?
はい。上記の月次ループはドメインのリストを処理し、それぞれに独自のファイルを作成します。リストは、各ドメインが毎月実際に読める程度に短く保ってください。読まれないウォッチは単なるストレージコストです。
インデックスは約月1回更新されるため、日次cronジョブは同じ画像をダウンロードするだけです。また、リンクリストは判決ではありません:行動する前に、Search Consoleのリンクレポートとすべてのフラグをペアにしてください。