
設定とプロフィールデータの仕様
startUrlsに保存されているサンプルのプロフィール2件のリスト全体を、対象とする既知のプロフィール1件に置き換えてください。
現在のInstagram Profileのビルド0.1.26では、startUrlsに公開プロフィールのURL、@付きのハンドル名、または@なしのハンドル名を1〜1,000件指定できます。完全に一致する重複入力文字列は1回だけ確認されます。1行は、処理を試みた入力1件を表します。利用できない状態を示す行も含まれます。
標準のフィールドは、input、channelId、eimuId、fbid、channelUrl、handle、displayName、description、externalUrl、bioLinks、biographyEntities、detectedEmails、detectedLinks、businessContactMethod、businessEmail、businessPhoneNumber、businessAddress、shouldShowPublicContacts、status、statusReason、observedAt、isBillableです。eimuIdは、このとおりの綴りを使ってください。fbidはMetaに関連付けられたIDであり、FacebookページIDではありません。
プロフィールのstatusには、ok、partial、private、login_required、not_found、blocked、challenge、rate_limited、parser_miss、invalid_input、failedのいずれかが入ります。statusReasonとobservedAtを保持してください。OUTPUTには、requestedChannels、acceptedProfileInputs、rejectedInputs、datasetRows、usefulRows、billableRows、nonUsefulRows、statusCountsが出力されます。
NASAのプロフィール1件を使ったテストでは、statusがokとなり、正しいchannelId、正規のchannelUrl、handle、description、externalUrl、detectedLinks、および5件のbioLinksが返されました。detectedEmailsは空の配列で、直接の業務用メールアドレスと電話番号はnullでした。この結果は、プロフィールの識別情報とリンクを取得できることを示します。すべてのアカウントに連絡先データがあることを示すものではありません。
連絡先に関する重要なフィールドには、externalUrl、bioLinks、detectedLinks、detectedEmails、businessEmail、businessPhoneNumber、businessContactMethod、shouldShowPublicContactsがあります。連絡先ボタンを示すフラグは、連絡先そのものの値ではありません。
手順
- 既知の公開プロフィールを用意し、連絡する目的を明確にします。このツールは、指定されたURLから、プロフィール上で公開されている手がかりを抽出します。地域別データベースを検索するものではありません。
- プロフィール1件でテストし、リンクを利用する前に、情報源が対象のプロフィールであること、状態、時刻を確認します。元のフィールドは別に保存します。連絡先ボタンを示すフラグは、連絡先そのものの値ではありません。
- 重複を除いたリンク候補またはメールアドレスらしき手がかりごとに、連絡経路の記録を1件作成します。プロフィールID、取得元フィールド、元の値、observedAt、想定する連絡経路の種類、確認状態を含めます。どのフィールドから取得したかという情報を保持します。ホスト名の大文字・小文字と末尾のスラッシュを、安全に正規化します。
- bioLinksまたはexternalUrlにある公開リンクと、descriptionのテキストから検出されたリンクを区別します。どちらも候補です。mailto形式の連絡経路は、公開されているアドレス文字列であり、メールが届くことの証明ではありません。公開メールアドレスや電話番号が見つからない場合は、取得不可のままにします。
- 対象とする公開リンク先のページを手動で開きます。最終的な移動先と、そのページが同じクリエイターのものか、業務用の問い合わせフォームがあるか、別の場所に転送されるか、利用できないかを記録します。このツールは、そのサイトをクロールしません。
- 確認状態は、unreviewed、checked_public_route、ambiguous、unavailable、rejectedのいずれかに限定します。公開連絡経路の確認済み状態は、記録した日時に手動で情報源との一致を確認したことだけを意味します。所有者やメールの到達可能性が検証済みであることは意味しません。
- 同じ確認済みプロフィールの連絡経路は、フィールドと情報源への参照を保持したまま重複を除きます。無関係なリンク集ページやアフィリエイトの転送先は、別に扱います。矛盾がある場合は、推測せずに記録します。
- 情報源へのリンク、手動確認の証拠、次の対応を含む連絡経路台帳を提出します。このガイドで扱う範囲は、連絡経路の確認までです。メッセージの送信は行いません。
架空の具体例
*(注:以下は、手順を示すために独自に作成した架空の例です。)*
架空のクリエイターID10001について、externalUrlは `https://green.example/contact`、bioLinksは同じURLと `https://links.example/green`、detectedEmailsは `["hello@green.example"]`、businessEmailは `null` という結果が返されます。取得元の情報を保持したうえで重複を除くと、4件の手がかりから3件の異なる連絡経路候補が得られます。手動で確認すると、`green.example/contact`は対象のクリエイターと一致する公開の業務用問い合わせフォームでした。リンク集ページは無関係なアカウントに転送され、検出されたメールアドレスは対象と一致するどの公開ページでも確認できませんでした。フォームをchecked_public_route、リンク集ページを理由付きでrejected、メールアドレスをambiguousと記録します。確認した候補3件のうち確認済みの連絡経路が1件という結果は、連絡経路の確認件数を表すものであり、メールアドレスの有効率ではありません。直接の業務用メールアドレスを格納するbusinessEmailフィールドは、nullのままです。2件目のプロフィールは収集時にブロックされたため、利用できる連絡先の証拠がありません。ただし、それはそのクリエイターに業務用連絡先がないことの証明にはなりません。
連絡経路の根拠一覧
| クリエイターと情報源URL | 取得元フィールド | 候補の元の値 | 手動確認した最終URLと確認日 | 根拠と状態 |
|---|---|---|---|---|
| `channelId10001` <br> `https://www.instagram.com/greenstudio/` | `externalUrl`、`bioLinks` | `https://green.example/contact` | `https://green.example/contact` <br> 確認日:2026-10-13 | 対象と一致する公開の業務用問い合わせフォーム、`checked_public_route` |
| `channelId10001` <br> `https://www.instagram.com/greenstudio/` | `bioLinks` | `https://links.example/green` | `https://other.example/profile` <br> 確認日:2026-10-13 | 架空の無関係なアカウントに転送、`rejected` |
| `channelId10001` <br> `https://www.instagram.com/greenstudio/` | `detectedEmails` | `hello@green.example` | なし/未確認 <br> 確認日:2026-10-13 | 最終的な公開情報源が対象と一致することを確認できず、`ambiguous` |
ツールの制限と対象範囲
Actorが手がかりを収集し、読者がリンク先を手動で確認します。外部サイトのクロールや、メールの到達可能性の証明は行いません。
出典と参考資料
著者 Chronometrica · 更新日
ページの先頭へ ↑

