SalesNow

シグナルの大カテゴリ・中カテゴリと、それぞれの有効なシグナルの件数を取得する（クレジット消費なし）。 list_signals で取得するカテゴリを決めるために、先に呼ぶ。エンタープライズプランのみ。

list_signal_categories

指定したカテゴリの有効なシグナルを、ページ単位で取得する（クレジット消費なし）。 search_companies の signal_ids に何を指定すればよいか確認したいときに使う。 中カテゴリ（middle_category_id）か大カテゴリ（large_category）のどちらか一方を必ず指定する。 カテゴリと件数は list_signal_categories で確認できる。エンタープライズプランのみ。 Args: middle_category_id: 中カテゴリID（list_signal_categories で取得） large_category: 大カテゴリ名 page: ページ番号（1から） per_page: 1ページの件数（1〜50）

list_signals

ニュースとプレスリリースを検索する。 N+1 呼び出しを避けてください。search_companies で返った全企業に対して このツールを繰り返し呼ばず、まず press_release_summary などで候補を絞ってください。 網羅的な深掘りをユーザーが明示しない限り、少数の候補にだけ使ってください。 corporate_number または date_from と date_to の両方が必要です。 日付範囲は通常 30 日以内で、corporate_number 指定時のみ 180 日以内です。 Args: corporate_number: 企業で絞り込むための13桁の法人番号 date_from: 開始日（YYYY-MM-DD） date_to: 終了日（YYYY-MM-DD、通常30日以内、corporate_number 指定時は180日以内） topic: トピックフィルタ（例: finance__m_and_a, business__new_product_and_service） page: ページ番号（1始まり） per_page: 1ページあたりの件数（1-50、デフォルト50）

search_news

一括名寄せタスクの処理状態を確認する。 bulk_collate_companies で作成したタスクの進捗を確認する。 status が completed になったら get_bulk_collate_result_csv で結果CSVを取得する。 status が failed の場合は処理に失敗している。 Args: task_id: bulk_collate_companies が返した task_id Returns: task_id、status（accepted / processing / completed / failed）、 total_count、processed_count、created_at を含む JSON を返す。

get_bulk_collate_status

作成済みの一括名寄せタスク一覧を取得する（作成日時の降順）。 bulk_collate_companies が返した task_id を紛失した場合の復元、 または過去タスクの進捗確認に使う。個別タスクの進捗・結果は 一覧で task_id を特定したうえで get_bulk_collate_status / get_bulk_collate_result_csv を呼ぶこと。 Args: limit: 取得件数（1〜50、既定 10） offset: オフセット（既定 0） status: ステータスで絞り込む場合に指定（accepted / processing / completed / failed）。 省略時は全件。 Returns: items（taskId / status / totalCount / processedCount / createdAt / startedAt / completedAt / errorMessage を含むオブジェクトの配列）と、 フィルタ適用後の total を含む JSON を返す。

list_bulk_collate_tasks

一括名寄せの結果をCSV形式で取得する。 get_bulk_collate_status で status が completed になった後に呼び出す。 Args: task_id: bulk_collate_companies が返した task_id Returns: BOM付きUTF-8のCSVテキストを返す。 合計25列。企業情報列: 企業名・法人番号・住所・従業員数・大業界・中業界(メイン/サブ)・小業界・設立年月・上場区分・代表者名・企業HP・売上・資本金・代表電話番号。 名寄せステータス: matched（1件特定）/ multiple_candidates(N)（複数候補・企業情報列は空欄）/ not_found（未特定） 入力データ警告: URLやメールアドレスの形式不正などの入力品質警告を `フィールド:メッセージ; …` 形式で出力。matched 行では常に空文字。

get_bulk_collate_result_csv

法人番号から企業の人物一覧を取得する（エンタープライズプランかつ Organization API の別途契約が必要）。 人事異動、Wantedly、LinkedIn 由来の人物情報を返します。 エンタープライズプラン以外、または Organization API の契約がないAPIキーでは利用できません。 Args: corporate_number: 13桁の法人番号 sort: ソート条件。例: startedOn:desc, name:asc page: ページ番号（1始まり） per_page: 1ページあたりの件数（1-50、デフォルト50）

search_persons

大量の企業データを一括で名寄せするタスクを作成する（非同期処理・CSV経由）。 このツールはサーバー上に非同期タスクを作成する書き込みツール。 クライアントのプラン、権限、または安全性設定によって利用できない場合がある。 50件以上の大量データに適している。処理は非同期で行われるため、 このツールはタスクIDを返す。その後 get_bulk_collate_status でポーリングし、 completed になったら get_bulk_collate_result_csv で結果CSVを取得する。 Args: companies: 名寄せ対象企業リストのJSON文字列。各要素は以下のフィールドを持つ: - row_id (任意): 元データとの突合用ID。省略時はインデックスが使われる - company_name (任意): 企業名 - company_url (任意): 企業URL - corporate_number (任意): 13桁の法人番号 - address (任意): 住所 - phone_number (任意): 電話番号 - mail_address (任意): メールアドレス 例: '[{"row_id":"1","company_name":"株式会社サンプル","company_url":"https://example.com"}]' ※ company_name、company_url、corporate_number のいずれかがあると精度が上がる is_exact_match_name_collation_enabled: 複数候補から会社名完全一致1社へ昇格するか is_exclude_closed_companies_from_collation: 廃業済み企業を除外するか is_exclude_inactive_companies_from_collation: 非活動見込み企業を除外するか Returns: task_id、status（accepted）、total_count を含む JSON を返す。 task_id を使って get_bulk_collate_status でポーリングすること。

bulk_collate_companies

部分情報から企業を特定し、正規化する。 分かる情報はできるだけ多く渡してください。精度のためには company_name、company_url、corporate_number のいずれかがあるのが望ましいです。 Args: company_name: 企業名 company_url: 企業URL corporate_number: 13桁の法人番号 address: 住所 phone_number: 電話番号（補助情報） mail_address: メールアドレス（補助情報） is_exact_match_name_collation_enabled: 複数候補から会社名完全一致1社へ昇格するか is_exclude_closed_companies_from_collation: 廃業済み企業を除外するか is_exclude_inactive_companies_from_collation: 非活動見込み企業を除外するか Returns: status（matched / multiple_candidates / not_found）、 count、results を含む JSON を返す。

collate_company

さまざまな条件で企業を検索する。 Args: keyword: 業界や企業説明のフリーワード検索（AND） large_industries: 大業界（OR）。例: ["IT", "製造"] small_industries: 中業界（OR）。例: ["クラウド系/SaaS/ASPサービス", "ソフトウェア販売"] business_tags: 業界タグ（OR）。例: ["人事管理ソフトウェア開発事業", "クラウドコンピューティングサービス事業"] prefectures: 都道府県フィルタ（OR）。例: ["東京都", "大阪府"] address_keyword: 所在地フリーワード検索（AND） cities: 市区町村フィルタ配列。例: [{"category":"東京都","keyword":"渋谷区"}] employee_number_over: 従業員数の下限 employee_number_under: 従業員数の上限 capital_stock_over: 資本金の下限（万円） capital_stock_under: 資本金の上限（万円） sales_over: 売上の下限（万円） sales_under: 売上の上限（万円） listing_categories: 上場区分（OR）。例: ["未上場", "プライム（内国株式）"] tob_toc: 業態フィルタ（OR）。例: ["BtoB", "BtoC"] has_email: メールアドレスありで絞り込むときは True has_phone_number: 電話番号ありで絞り込むときは True has_contact_form: 問い合わせフォーム有無で絞り込む has_url: 企業URL有無で絞り込む net_sales_over: 有報ベース売上高の下限（万円） net_sales_under: 有報ベース売上高の上限（万円） profit_loss_over: 有報ベース純利益の下限（万円） profit_loss_under: 有報ベース純利益の上限（万円） market_cap_over: 時価総額の下限（万円） market_cap_under: 時価総額の上限（万円） salesnow_score_over: SalesNow スコア下限（0-100、未指定時はチームの検索デフォルト設定。未設定なら1） salesnow_score_under: SalesNow スコア上限（0-100、未指定時はチームの検索デフォルト設定。未設定なら100） credit_score_over: 与信スコア下限（0-100） credit_score_under: 与信スコア上限（0-100） activity_topics: アクティビティトピック（OR） activity_from_date: アクティビティ期間の開始日（YYYY-MM-DD） activity_to_date: アクティビティ期間の終了日（YYYY-MM-DD） activity_keyword: アクティビティ本文やタイトルのフリーワード検索 press_release_keyword: プレスリリースキーワード検索 press_release_tags: プレスリリースタグ（OR） company_names: 企業名リスト（AND 部分一致、最大10件） establish_from: 設立年月の下限（YYYY-MM） establish_to: 設立年月の上限（YYYY-MM） period_months: 決算月（OR、1-12）。例: [3, 9] technology_tags: テクノロジータグ（OR） employee_delta_ratio_from: 従業員増減率の下限（1%=0.01） employee_delta_ratio_to: 従業員増減率の上限（1%=0.01） employee_delta_comparison_period: 従業員増減率の比較期間 financial_sales_delta_ratio_from: 売上高前年同期比の下限（1%=0.01） financial_sales_delta_ratio_to: 売上高前年同期比の上限（1%=0.01） financial_profit_loss_delta_ratio_from: 純利益前年同期比の下限（1%=0.01） financial_profit_loss_delta_ratio_to: 純利益前年同期比の上限（1%=0.01） signal_ids: シグナルID（OR）。例: ["F1-02"]。有効な値は list_signal_categories → list_signals で確認（エンタープライズプランのみ） signal_large_categories: シグナルの大カテゴリ（OR）。signal_ids と併用した場合はいずれかに該当 include_signals: true の場合、各企業の該当シグナルの一覧を返す（シグナル条件の指定時は、そのうち該当したもののみ。エンタープライズプランのみ。個人プランでは 403 になり、signals は null） page: ページ番号（1始まり） per_page: 1ページあたりの件数（デフォルト50、最大50） Returns: items (企業一覧: basicInfo 14項目 / industry 4項目 / size 4項目 / score 2項目 / signals) と pagination (page, perPage, totalCount) を含む JSON を返す。

search_companies