n8n
コードなしで、ワークフローに企業データを。
n8nノードを使うと、コードなしでワークフローに企業データを取り込めます。このノードはn8nの検証済みで、自社ソフトウェアと同じAPIを呼び出します。
ノードをインストールする
検証済みノードはエディタから直接インストールします。これができるのはn8nインスタンスのオーナーまたは管理者だけで、その後はすべてのメンバーがノードを使えます。
- ワークフローを開き、「+」をクリックしてノードパネルを開きます。
- 「handelsregister.ai」を検索し、検証済みバッジの付いたノードを選びます。
- 「Install」をクリックします。
- 「Handelsregister.ai API」の認証情報を作成し、APIキーを入力します。代わりにBearerトークンも使えます。
セルフホストのインスタンスでは、Settings › Community Nodesでパッケージ名@handelsregister/n8n-nodes-handelsregister-aiを指定してノードをインストールすることもできます。
検証済みノードがインスタンスに表示されるかどうかは、その設定によります。n8n Cloudでは、オーナーがCloudの管理パネルでこれを制御します。
オペレーション
ノードはAPIのエンドポイントをオペレーションとして提供します。クレジットはAPIと同じです。
| オペレーション | 内容 | クレジット |
|---|---|---|
| Fetch Organization | 機能、AIモード、リアルタイムを選べる企業プロフィール。 | 5 + 機能 |
| Search Organizations | 名称とフィルターで企業を検索。「Return All」はすべての結果をページ送りし、「Maximum Results」は件数を制限します。 | 1ページあたり 1 |
| Fetch Person | 人物プロフィール（Plus以上）。 | 15 |
| Fetch Document | 登記簿の書類。ファイルはバイナリプロパティ「data」に入ります。 | 15 |
| List Signals | トピック、企業、期間によるSignals。ページごとに。 | 1ページあたり 20 |
| Get Signal | シグナル1件。 | 20 |
| Get Signal Catalog | Signalsのトピック。 | 無料 |
読み取りリクエストでは、ノードはネットワークエラー、408、429、サーバーエラーを最大3回再試行します。「Continue On Fail」を使うとワークフローは続行し、結果にはステータス、エラーコード、metaが含まれます。
ワークフローの例
このワークフローは、ある郵便番号エリアで活動中のすべてのGmbHのリストを、それぞれの経営陣付きで作成します。
- トリガーから始めます。例えば試すなら「Manual Trigger」、固定のスケジュールなら「Schedule Trigger」です。
- 「Search Organizations」オペレーションでhandelsregister.aiノードを追加します。フィルターで郵便番号、法的形態GmbH、ステータスactiveを設定します。
- 「Output」を企業1社につき1アイテムに設定します。「Return All」をオンにし、「Maximum Results」で件数を制限します。そうすれば、後に続く企業プロフィールの数が事前にわかります。
- 「Fetch Organization」で2つ目のhandelsregister.aiノードを追加します。
qに式{{ $json.entity_id }}を入力し、機能Related Persons（経営陣）を選びます。 - 結果を送信先に書き出します。例えばスプレッドシートやCRMです。
検索の各ページは 1 クレジット です。各企業プロフィールは 5 クレジット で、経営陣がデータを返せば 2 クレジット が加わります。