TOOL REFERENCE

Tool リファレンス

RAKUDA Atlas は公開 16 tool を MCP 経由で出している。引数・件数カウント・サンプル response を網羅したリファレンス。ラクダがちゃんと記憶してから走り出すために、 このページを見ながら呼んでほしい。

件数カウントの読み方

固定月額 ¥15,000/月(税別)。下記の件数は料金ではなく、 月 10 万件の取得枠の消費量。無料枠・従量課金はなし。

1 行 1 件
応答に含まれる行 (会社/部署) ごとに枠を 1 件消費。月 10 万件まで定額に含まれる。
lookup 1 件
ID 直接参照系。get_company_detail は found / not found 共通で 1 件。
1 call 1 件
EDINET / Employee 系の特殊集計 tool。返却行数に関係なく call 単位で 1 件。
枠を消費しない / card 必須
利用量・カバレッジ・辞書の参照系。カード登録は必須 (なりすまし防止)。件数を消費しない。
9 件 / 39 件 / 199 件
AI 深掘り系 (enrich_company, find_succession_candidates, find_abm_targets)。1 call でまとめて消費。30 日キャッシュ。
月の取得上限
定額に含まれる枠は 月 10 万件。到達後は call が blocked。dashboard で月内残量を確認でき、引き上げは support に相談。

目次

基本 8 tool — 件数消費が軽い

  1. 01search_companies法人マスタ検索
  2. 02search_departments部署マスタ検索
  3. 03get_company_detailID 詳細
  4. 04export_to_csvCSV 出力
  5. 05usage_summary利用量サマリ
  6. 06db_statsDB 件数
  7. 07fts_search_companies曖昧検索 + 辞書展開
  8. 08list_categories業種辞書

拡張 8 tool — 深掘り・特化

  1. 09enrich_companyAI 深掘り
  2. 10find_succession_candidatesM&A 事業承継
  3. 11find_abm_targetsABM 営業
  4. 12find_ec_companiesEC 出店者
  5. 13find_growth_companiesEDINET 連続成長
  6. 14get_company_financialsEDINET 財務 N 年
  7. 15find_market_leaders連続黒字・利益上位
  8. 16find_active_companiesプレス活動シグナル

基本 8 tool

検索・取得・CSV・利用量。MCP に繋いだ初日はここから始める。

search_companies

1 行 1 件 (枠消費)

法人マスタ (4.64M 件、国内法人母数 80%) を name / 都道府県 / 業種 / 規模 / 資本 / 売上 で検索。FTS5 ではなく LIKE/= の構造化フィルタ用。

nametyperequireddescription
namestring (≤200)任意社名 prefix 一致 (default)。allow_wildcard=true で % _ 利用可
prefecturestring任意都道府県 完全一致 (例: "東京都")
citystring任意市区町村 中間一致 (例: "渋谷区"、"横浜市西区")
industry_typestring任意業種 LIKE 部分一致。実値は list_categories の industry_type_values 参照
sizestring任意規模カテゴリ 完全一致
employees_min / employees_maxint任意従業員数の下限/上限
capital_min / capital_maxint任意資本金 (円) の下限/上限
sales_min / sales_maxint任意売上 (円) の下限/上限
has_homepagebool任意true: HP あり / false: HP なし
has_phonebool任意true: 代表電話あり / false: なし
is_listedbool任意true: 上場のみ / false: 非上場のみ / 未指定: 両方
marketenum任意上場市場 (例: "東証プライム")
allow_wildcardbool (default false)任意name に % _ を含めて LIKE wildcard を有効化
limitint 1-500 (default 50)任意返却件数の上限
offsetint 0-50000 (default 0)任意ページネーション
business_query / category_idstring任意業種カテゴリ自然語/辞書 ID。指定された場合は fts_search_companies に誘導 (本 tool では throw)

input

{
  "tool": "search_companies",
  "args": {
    "prefecture": "東京都",
    "industry_type": "ソフトウェア",
    "employees_min": 50,
    "limit": 3
  }
}

response (抜粋)

{
  "companies": [
    { "uuid": "...", "name": "サイボウズ株式会社",
      "prefecture": "東京都", "industry_type": "ソフトウェア・SI",
      "number_of_employees": 1200, "capital": 613400000 },
    ...
  ],
  "returned": 3,
  "has_more": true
}

search_departments

1 行 1 件 (枠消費)

部署マスタ (1.6M 件) を会社名 / 部署名 / integrated_company_id で検索。担当部署を狙ったアウトバウンドに使う。

nametyperequireddescription
company_namestring (≤200)任意社名 prefix 一致
department_namestring (≤200)任意部署名 prefix 一致 (例: "情報システム")
integrated_company_idstring任意親会社 integrated_id 完全一致
has_personnelbool任意true: 担当者紐付きあり / false: なし
allow_wildcardbool (default false)任意% _ を含めて LIKE wildcard を有効化
limitint 1-500 (default 50)任意返却件数
offsetint 0-50000 (default 0)任意ページネーション

input

{
  "tool": "search_departments",
  "args": {
    "department_name": "情報システム",
    "has_personnel": true,
    "limit": 2
  }
}

response (抜粋)

{
  "departments": [
    { "id": 123, "company_name": "...",
      "department_name": "情報システム部",
      "telephone": "03-...", "has_personnel": 1 },
    ...
  ],
  "returned": 2,
  "has_more": true
}

get_company_detail

lookup 1 件 (found / not found 共通)

uuid / corporate_number / integrated_id のいずれか 1 つで法人詳細 + 部署一覧 + EC で観測した電話プールを取得。

nametyperequireddescription
uuidstring 8-40 [A-Za-z0-9_-]任意Atlas 内部 UUID
corporate_numberstring (13 桁数字)任意国税庁法人番号
integrated_idstring 8-40 [A-Za-z0-9_-]任意統合 ID。3 つのうち 1 つだけ指定 (複数同時はエラー)

input

{
  "tool": "get_company_detail",
  "args": { "corporate_number": "1010001034780" }
}

response (抜粋)

{
  "found": true,
  "company": { "name": "...", "industry_type": "...",
               "homepage_url": "...", "telephone_number": "...",
               "capital": 100000000, "sales": 500000000 },
  "departments": [ { "department_name": "営業部", ... } ],
  "observed_phones": [
    { "phone": "0312345678", "source": "rakuten",
      "matches_master": true }
  ]
}

export_to_csv

1 行 1 件 (枠消費)

search_companies / search_departments の検索結果を CSV (BOM 付き UTF-8) で出力。応答に CSV テキストを直接埋め込む。

nametyperequireddescription
source"search_companies" | "search_departments"必須discriminator。fields の whitelist もこれで切り替わる
argsobject必須source 対応の検索引数 (limit / offset / allow_wildcard を除く)
fieldsarray<enum>任意出力カラム (whitelist)。未指定で全カラム。重複は自動 unique 化。companies 21 列 / departments 7 列
limitint 1-5000 (default 1000)任意CSV 行数上限。2 MiB を超えると CsvSizeExceededError

input

{
  "tool": "export_to_csv",
  "args": {
    "source": "search_companies",
    "args": { "prefecture": "東京都", "is_listed": true },
    "fields": ["name", "corporate_number", "homepage_url", "sales"],
    "limit": 500
  }
}

response (抜粋)

{
  "rows_written": 500,
  "csv": "\uFEFFname,corporate_number,homepage_url,sales\n..."
}

usage_summary

枠を消費しない / card 必須

自分の API key の利用量サマリを返す。tool 別の呼び出し回数 / 行数 / リスト課金 / エラー率を含む。

nametyperequireddescription
period"today" | "week" | "month" | "all" (default today)任意集計期間。今日 / 7 日 / 月初〜現在 / 全期間。境界は JST

input

{
  "tool": "usage_summary",
  "args": { "period": "month" }
}

response (抜粋)

{
  "period": "month",
  "total_calls": 142,
  "total_lists": 980,
  "billing_month_units": 980,
  "free_tier_remaining": 0,
  "billable_yen": 480,
  "by_tool": [
    { "tool": "search_companies", "calls": 80,
      "rows": 600, "units": 600 },
    ...
  ]
}

db_stats

枠を消費しない / card 必須

DB 全体の件数とカバー率を返す (引数なし)。法人/部署の母数を Claude/Cursor 側で踏まえたい時に。

nametyperequireddescription
引数なし。

input

{ "tool": "db_stats", "args": {} }

response (抜粋)

{
  "master_companies": 4646843,
  "master_departments": 1621239,
  "coverage": { "companies_pct": "80.03%" }
}

fts_search_companies

1 行 1 件 (枠消費)

FTS5 trigram + 業種辞書展開で曖昧クエリ法人検索。例: business_query="塗装工事" で「塗装/外装/ペイント/塗料/防水」全部に展開して BM25 ランキング。

nametyperequireddescription
querystring (≤200)任意自由テキスト全文検索 (FTS5 BM25)
business_querystring (≤200)任意業務カテゴリ自然語。同義語辞書で展開後 FTS5 検索
category_idstring任意辞書のカテゴリ ID 直指定 (例: "construction_painting")
prefecturestring任意都道府県フィルタ
employees_min / employees_maxint任意従業員数フィルタ
capital_minint任意資本金下限
limitint 1-500 (default 50)任意返却件数。query / business_query / category_id のいずれか必須

input

{
  "tool": "fts_search_companies",
  "args": { "business_query": "塗装工事", "limit": 3 }
}

response (抜粋)

{
  "companies": [
    { "name": "...塗装株式会社", "prefecture": "...",
      "industry_type": "塗装工事", "number_of_employees": 8 },
    ...
  ],
  "returned": 3,
  "has_more": true,
  "expanded_keywords": ["塗装", "外装", "ペイント", "塗料", "防水"],
  "fts_query": "\"塗装\" OR \"外装\" OR \"ペイント\" OR ..."
}

list_categories

枠を消費しない / card 必須

業種参照用。fts_search_companies(category_id) 用の辞書と、search_companies(industry_type) 用の DB 実値一覧を同梱で返す。軸が別なので混同しないこと。

nametyperequireddescription
引数なし。

input

{ "tool": "list_categories", "args": {} }

response (抜粋)

{
  "categories": [
    { "id": "construction_painting",
      "name_ja": "塗装工事",
      "keywords": ["塗装", "外装", "ペイント", "塗料", "防水"] },
    ...
  ],
  "industry_type_values": [
    "ソフトウェア・SI",
    "総合(建設・建築)",
    ...
  ]
}

拡張 8 tool

AI 深掘り (enrich)、M&A / ABM 特化、EC 出店者、EDINET 財務、プレスシグナル。 基本 8 で母集団を絞ってからこちらを叩く。

enrich_company

basic 9 件 / deep 39 件

法人 1 件を Perplexity + Claude で深掘り。basic: 概要・最近のニュース・主要事業 / deep: 業績・役員・プロダクト・採用・資金調達まで横断。30 日キャッシュ (cache hit でも同単価)。

nametyperequireddescription
idstring 1-40必須対象 ID。id_type に応じて corporate_number (13 桁) / uuid (8 文字以上) / integrated_id (8 文字以上)
id_type"corporate_number" | "uuid" | "integrated_id" (default corporate_number)任意id の種別
depth"basic" | "deep" | "executive_age" | "abm" (default basic)任意深掘りレベル。executive_age / abm は find_succession / find_abm から内部利用される値
force_refreshbool (default false)任意true で 30 日キャッシュを無視して再取得
output_format"full" | "concise" (default full)任意concise は depth=abm 用の 3 行サマリ (モバイル即答シナリオ)

input

{
  "tool": "enrich_company",
  "args": {
    "id": "1010001034780",
    "id_type": "corporate_number",
    "depth": "basic"
  }
}

response (抜粋)

{
  "cost_yen": 9,
  "from_cache": false,
  "content": {
    "summary": "クラウド型業務改善PFを開発・提供する...",
    "news_recent": [ { "title": "...", "date": "2026-04-12" } ],
    "main_business": ["kintone", "Garoon", "..."]
  }
}

find_succession_candidates

pool_size × 39 件 (枠消費)

M&A 事業承継候補を発掘。母集団絞り (prefecture / business_query / established_before_year / sales) → 各社で enrich(executive_age) を並列 → 代表者年齢でスコアリング → 上位 N 件 + reasoning を返す。

nametyperequireddescription
prefecturestring任意都道府県フィルタ
business_querystring任意業務カテゴリ自然語 (例: "建設業")。FTS 辞書展開で母集団取得
industry_typestring任意業種フィルタ (LIKE 部分一致)
sales_min / sales_maxint任意売上 (円) フィルタ
employees_min / employees_maxint任意従業員数フィルタ
established_before_yearint 1900-2030任意設立年がこの年以前 (例: 2000 で 25 年以上の老舗のみ)
pool_sizeint 10-200 (default 50)任意母集団から enrich する件数。多いほど精度高いが課金増
limitint 1-50 (default 20)任意上位 N 件を返却

input

{
  "tool": "find_succession_candidates",
  "args": {
    "prefecture": "新潟県",
    "business_query": "金属加工",
    "established_before_year": 1990,
    "pool_size": 30, "limit": 10
  }
}

response (抜粋)

{
  "enrich_cost_yen": 1170,
  "candidates": [
    { "name": "...製作所", "executive_age": 72,
      "executive_name": "...", "score": 0.91,
      "sales": 850000000,
      "reasoning": "代表 72 歳・設立 1968 年・後継不在シグナル..." },
    ...
  ],
  "returned": 10
}

find_abm_targets

pool_size × 199 件 (枠消費)

ABM 営業ターゲット発掘。search で母集団取得 → 各社 enrich(depth=abm) を並列 → buying_signals.strength で sort → 上位 N 件 + top talking_point + top decision_maker + reasoning。エンプラセールス / ABM 支援会社向け。

nametyperequireddescription
prefecturestring任意都道府県フィルタ
business_querystring任意業務カテゴリ自然語 (FTS 辞書展開)
industry_typestring任意業種フィルタ
sales_min / sales_maxint任意売上フィルタ
employees_min / employees_maxint任意従業員数フィルタ
pool_sizeint 3-30 (default 10)任意母集団から enrich する件数。各社 199 円課金
limitint 1-20 (default 10)任意上位 N 件を返却
min_buying_signal_strengthnumber 0-1任意この強度以上の買いシグナルがある会社のみに絞る (例: 0.7)

input

{
  "tool": "find_abm_targets",
  "args": {
    "industry_type": "ソフトウェア",
    "employees_min": 100,
    "pool_size": 10, "limit": 5,
    "min_buying_signal_strength": 0.6
  }
}

response (抜粋)

{
  "enrich_cost_yen": 1990,
  "targets": [
    { "name": "...", "max_buying_signal_strength": 0.82,
      "top_buying_signal": {
        "signal": "CRO 新任 + Salesforce 採用記事",
        "timing_window": "向こう 30 日以内", ... },
      "top_talking_point": { "hook": "...", ... },
      "top_decision_maker": { "name": "...", "title": "VP Sales",
                              "best_channel": "LinkedIn" },
      "reasoning": "..." }
  ]
}

find_ec_companies

1 行 1 件 (枠消費)

楽天市場 / Yahoo!ショッピング に出店している法人を絞る。confidence A (2 シグナル以上一致 + 矛盾なし) のみ返却。

nametyperequireddescription
source"rakuten" | "yahoo" | "any" (default any)任意絞り込むモール。any なら楽天/Yahoo 両方
prefecturestring任意都道府県フィルタ
employees_min / employees_maxint任意従業員数フィルタ
has_phonebool任意true: 代表電話あり / false: なし
limitint 1-500 (default 50)任意返却件数
offsetint 0-50000 (default 0)任意ページネーション

input

{
  "tool": "find_ec_companies",
  "args": { "source": "rakuten", "prefecture": "大阪府", "limit": 3 }
}

response (抜粋)

{
  "companies": [
    { "name": "...商店", "corporate_number": "...",
      "prefecture": "大阪府", "homepage_url": "...",
      "ec_sources": ["rakuten"], "source_count": 2 },
    ...
  ],
  "returned": 3,
  "has_more": true
}

find_growth_companies

1 call 1 件 (枠消費)

EDINET 財務履歴から、売上 / 純利益 / 従業員数が指定年数連続で YoY 成長している法人を検索。

nametyperequireddescription
metric"sales" | "net_income" | "employees" (default sales)任意成長を見る指標
min_consecutive_yearsint 2-10 (default 3)任意連続成長必須年数
min_yoy_ratenumber (default 0.10)任意各年の YoY 下限 (0.10 = +10%)
end_fiscal_yearint 1900-2100任意最終評価対象の fiscal_year (未指定で最新)
prefecture / industry_type / marketstring / string / enum任意母集団フィルタ
sales_min / sales_maxint任意最新期の売上フィルタ
employees_min / employees_maxint任意最新期の従業員数フィルタ
limitint 1-500 (default 50)任意返却件数

input

{
  "tool": "find_growth_companies",
  "args": {
    "metric": "sales",
    "min_consecutive_years": 4,
    "min_yoy_rate": 0.15,
    "market": "東証グロース",
    "limit": 5
  }
}

response (抜粋)

{
  "companies": [
    { "name": "...", "corporate_number": "...",
      "consecutive_years": 4, "latest_sales": 1820000000,
      "yoy_rates": [0.21, 0.18, 0.16, 0.15] }
  ],
  "returned": 5
}

get_company_financials

1 call 1 件 (枠消費)

法人番号から EDINET 財務履歴を直近 N 年分取得。売上 / 営業利益 / 経常利益 / 純利益 / 従業員数 / 平均年齢 / 平均年収と YoY を返す。

nametyperequireddescription
corporate_numberstring (13 桁数字)必須国税庁法人番号
yearsint 1-10 (default 5)任意取得年数 (新しい順)

input

{
  "tool": "get_company_financials",
  "args": { "corporate_number": "5010401024847", "years": 3 }
}

response (抜粋)

{
  "company": { "name": "...", "industry_type": "...",
               "listed_markets": "[\"東証プライム\"]" },
  "financials": [
    { "fiscal_year": 2025, "sales": 218000000000,
      "net_income": 15400000000, "employees": 3200,
      "avg_age": 38.5, "avg_salary": 7820000,
      "sales_yoy": 0.18, "net_income_yoy": 0.31 },
    ...
  ],
  "returned": 3
}

find_market_leaders

1 call 1 件 (枠消費)

EDINET 財務履歴から、連続黒字・純利益・市場・業種条件で利益上位企業を検索。

nametyperequireddescription
net_income_minint任意最新期の純利益 (円) 下限
consecutive_profit_yearsint 1-10任意連続黒字年数の下限
marketenum任意上場市場 (例: "東証プライム")
industry_typestring任意業種フィルタ
limitint 1-500 (default 50)任意返却件数

input

{
  "tool": "find_market_leaders",
  "args": {
    "consecutive_profit_years": 5,
    "net_income_min": 10000000000,
    "market": "東証プライム", "limit": 5
  }
}

response (抜粋)

{
  "companies": [
    { "name": "...", "latest_net_income": 41200000000,
      "consecutive_profit_years": 7,
      "profit_start_year": 2019, "profit_end_year": 2025 }
  ],
  "returned": 5
}

find_active_companies

1 行 1 件 (枠消費)

プレスリリース / 適時開示の活動シグナルから、資金調達・提携・新サービス・採用強化など直近で動きがある法人を検索。

nametyperequireddescription
signal_typesarray<enum> 1-8必須funding / ma / product / hiring / office / ipo / security / partnership の組合せ
date_from / date_tostring YYYY-MM-DD任意観測期間。未指定で直近 30 日
prefecturestring任意都道府県フィルタ
industry_typestring任意業種フィルタ
business_querystring任意業務カテゴリ自然語 (FTS 辞書展開)
min_strengthint 0-100任意シグナル強度の下限
min_signal_countint ≥1 (default 1)任意対象期間内に観測されたシグナル数の下限
limitint 1-500 (default 50)任意返却件数
offsetint 0-50000 (default 0)任意ページネーション

input

{
  "tool": "find_active_companies",
  "args": {
    "signal_types": ["funding", "hiring"],
    "date_from": "2026-03-01",
    "prefecture": "東京都",
    "min_signal_count": 2,
    "limit": 5
  }
}

response (抜粋)

{
  "companies": [
    { "name": "...", "corporate_number": "...",
      "signals": [
        { "type": "funding", "date": "2026-04-02",
          "title": "シリーズ B 12 億円調達", "strength": 85 },
        { "type": "hiring", "date": "2026-04-18",
          "title": "セールス・エンジニア急募", "strength": 60 }
      ],
      "signal_count": 2 }
  ],
  "returned": 5
}

これで 16 tool 全部。

まずは db_stats list_categories で母数と業種辞書を確認、その後 fts_search_companies search_companies で母集団を絞ってから深掘り。