ワークフロー
リストビルダー
公開情報・公式 API をもとに営業候補企業を自動発見し、ターゲットリストへ追加する機能です。
3 つの入力モード
URL モード
業界ランキング・DX 認定企業一覧などのページ URL を入力。ページネーションを自動踏破して企業情報を抽出します。
https://example.com/dx-certified-list
自然言語モード
「東京の IT 企業で従業員 100〜500 名」など自由文を入力。SerpAPI が構造化クエリに変換して検索します。
SerpAPI キーが必要
カテゴリモード
業種・地域・従業員数・売上規模のプリセット UI から選択。国税庁法人番号 API + gBizINFO で取得します。
houjinBangou / gBizInfo キー推奨
使い方
- ダッシュボード右上の リストビルダー アイコンをクリック(または
/list-builderにアクセス) - 入力モードを選択し、条件を入力して「実行」
- バックグラウンドで企業発見・検証・適合度評価が実行されます
- 結果プレビューから追加したい企業を選択して「ターゲットリストに追加」
- ターゲットリスト(
data/targets.xlsx)に自動追記されます
必要な API キー
data/settings.json の apiKeys に設定してください:
| キー | 取得先 | 備考 |
|---|---|---|
| serpApi | serpapi.com | 自然言語・カテゴリモードで必須。有料(無料トライアルあり) |
| houjinBangou | houjin-bangou.nta.go.jp | 国税庁。無料・推奨 |
| gBizInfo | info.gbiz.go.jp | 経産省。無料・推奨 |
| edinet | edinet-api.fsa.go.jp | 上場企業の売上厳密判定用。任意 |
設計原則
- 公開情報のみを取得(CAPTCHA 回避・不正アクセスは行わない)
- 公式データソース優先(法人番号 API → gBizINFO → EDINET → SerpAPI → スクレイピング)
- 人間確認型: 自動でターゲットリストに追加せず、プレビュー → commit を経由
- Suppression List による重複・除外管理