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 — 件数消費が軽い
- 01
search_companies— 法人マスタ検索 - 02
search_departments— 部署マスタ検索 - 03
get_company_detail— ID 詳細 - 04
export_to_csv— CSV 出力 - 05
usage_summary— 利用量サマリ - 06
db_stats— DB 件数 - 07
fts_search_companies— 曖昧検索 + 辞書展開 - 08
list_categories— 業種辞書
拡張 8 tool — 深掘り・特化
- 09
enrich_company— AI 深掘り - 10
find_succession_candidates— M&A 事業承継 - 11
find_abm_targets— ABM 営業 - 12
find_ec_companies— EC 出店者 - 13
find_growth_companies— EDINET 連続成長 - 14
get_company_financials— EDINET 財務 N 年 - 15
find_market_leaders— 連続黒字・利益上位 - 16
find_active_companies— プレス活動シグナル
基本 8 tool
検索・取得・CSV・利用量。MCP に繋いだ初日はここから始める。
search_companies
1 行 1 件 (枠消費)法人マスタ (4.64M 件、国内法人母数 80%) を name / 都道府県 / 業種 / 規模 / 資本 / 売上 で検索。FTS5 ではなく LIKE/= の構造化フィルタ用。
| name | type | required | description |
|---|---|---|---|
name | string (≤200) | 任意 | 社名 prefix 一致 (default)。allow_wildcard=true で % _ 利用可 |
prefecture | string | 任意 | 都道府県 完全一致 (例: "東京都") |
city | string | 任意 | 市区町村 中間一致 (例: "渋谷区"、"横浜市西区") |
industry_type | string | 任意 | 業種 LIKE 部分一致。実値は list_categories の industry_type_values 参照 |
size | string | 任意 | 規模カテゴリ 完全一致 |
employees_min / employees_max | int | 任意 | 従業員数の下限/上限 |
capital_min / capital_max | int | 任意 | 資本金 (円) の下限/上限 |
sales_min / sales_max | int | 任意 | 売上 (円) の下限/上限 |
has_homepage | bool | 任意 | true: HP あり / false: HP なし |
has_phone | bool | 任意 | true: 代表電話あり / false: なし |
is_listed | bool | 任意 | true: 上場のみ / false: 非上場のみ / 未指定: 両方 |
market | enum | 任意 | 上場市場 (例: "東証プライム") |
allow_wildcard | bool (default false) | 任意 | name に % _ を含めて LIKE wildcard を有効化 |
limit | int 1-500 (default 50) | 任意 | 返却件数の上限 |
offset | int 0-50000 (default 0) | 任意 | ページネーション |
business_query / category_id | string | 任意 | 業種カテゴリ自然語/辞書 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 で検索。担当部署を狙ったアウトバウンドに使う。
| name | type | required | description |
|---|---|---|---|
company_name | string (≤200) | 任意 | 社名 prefix 一致 |
department_name | string (≤200) | 任意 | 部署名 prefix 一致 (例: "情報システム") |
integrated_company_id | string | 任意 | 親会社 integrated_id 完全一致 |
has_personnel | bool | 任意 | true: 担当者紐付きあり / false: なし |
allow_wildcard | bool (default false) | 任意 | % _ を含めて LIKE wildcard を有効化 |
limit | int 1-500 (default 50) | 任意 | 返却件数 |
offset | int 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 で観測した電話プールを取得。
| name | type | required | description |
|---|---|---|---|
uuid | string 8-40 [A-Za-z0-9_-] | 任意 | Atlas 内部 UUID |
corporate_number | string (13 桁数字) | 任意 | 国税庁法人番号 |
integrated_id | string 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 テキストを直接埋め込む。
| name | type | required | description |
|---|---|---|---|
source | "search_companies" | "search_departments" | 必須 | discriminator。fields の whitelist もこれで切り替わる |
args | object | 必須 | source 対応の検索引数 (limit / offset / allow_wildcard を除く) |
fields | array<enum> | 任意 | 出力カラム (whitelist)。未指定で全カラム。重複は自動 unique 化。companies 21 列 / departments 7 列 |
limit | int 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 別の呼び出し回数 / 行数 / リスト課金 / エラー率を含む。
| name | type | required | description |
|---|---|---|---|
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 側で踏まえたい時に。
| name | type | required | description |
|---|---|---|---|
| 引数なし。 | |||
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 ランキング。
| name | type | required | description |
|---|---|---|---|
query | string (≤200) | 任意 | 自由テキスト全文検索 (FTS5 BM25) |
business_query | string (≤200) | 任意 | 業務カテゴリ自然語。同義語辞書で展開後 FTS5 検索 |
category_id | string | 任意 | 辞書のカテゴリ ID 直指定 (例: "construction_painting") |
prefecture | string | 任意 | 都道府県フィルタ |
employees_min / employees_max | int | 任意 | 従業員数フィルタ |
capital_min | int | 任意 | 資本金下限 |
limit | int 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 実値一覧を同梱で返す。軸が別なので混同しないこと。
| name | type | required | description |
|---|---|---|---|
| 引数なし。 | |||
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 でも同単価)。
| name | type | required | description |
|---|---|---|---|
id | string 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_refresh | bool (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 を返す。
| name | type | required | description |
|---|---|---|---|
prefecture | string | 任意 | 都道府県フィルタ |
business_query | string | 任意 | 業務カテゴリ自然語 (例: "建設業")。FTS 辞書展開で母集団取得 |
industry_type | string | 任意 | 業種フィルタ (LIKE 部分一致) |
sales_min / sales_max | int | 任意 | 売上 (円) フィルタ |
employees_min / employees_max | int | 任意 | 従業員数フィルタ |
established_before_year | int 1900-2030 | 任意 | 設立年がこの年以前 (例: 2000 で 25 年以上の老舗のみ) |
pool_size | int 10-200 (default 50) | 任意 | 母集団から enrich する件数。多いほど精度高いが課金増 |
limit | int 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 支援会社向け。
| name | type | required | description |
|---|---|---|---|
prefecture | string | 任意 | 都道府県フィルタ |
business_query | string | 任意 | 業務カテゴリ自然語 (FTS 辞書展開) |
industry_type | string | 任意 | 業種フィルタ |
sales_min / sales_max | int | 任意 | 売上フィルタ |
employees_min / employees_max | int | 任意 | 従業員数フィルタ |
pool_size | int 3-30 (default 10) | 任意 | 母集団から enrich する件数。各社 199 円課金 |
limit | int 1-20 (default 10) | 任意 | 上位 N 件を返却 |
min_buying_signal_strength | number 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 シグナル以上一致 + 矛盾なし) のみ返却。
| name | type | required | description |
|---|---|---|---|
source | "rakuten" | "yahoo" | "any" (default any) | 任意 | 絞り込むモール。any なら楽天/Yahoo 両方 |
prefecture | string | 任意 | 都道府県フィルタ |
employees_min / employees_max | int | 任意 | 従業員数フィルタ |
has_phone | bool | 任意 | true: 代表電話あり / false: なし |
limit | int 1-500 (default 50) | 任意 | 返却件数 |
offset | int 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 成長している法人を検索。
| name | type | required | description |
|---|---|---|---|
metric | "sales" | "net_income" | "employees" (default sales) | 任意 | 成長を見る指標 |
min_consecutive_years | int 2-10 (default 3) | 任意 | 連続成長必須年数 |
min_yoy_rate | number (default 0.10) | 任意 | 各年の YoY 下限 (0.10 = +10%) |
end_fiscal_year | int 1900-2100 | 任意 | 最終評価対象の fiscal_year (未指定で最新) |
prefecture / industry_type / market | string / string / enum | 任意 | 母集団フィルタ |
sales_min / sales_max | int | 任意 | 最新期の売上フィルタ |
employees_min / employees_max | int | 任意 | 最新期の従業員数フィルタ |
limit | int 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 を返す。
| name | type | required | description |
|---|---|---|---|
corporate_number | string (13 桁数字) | 必須 | 国税庁法人番号 |
years | int 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 財務履歴から、連続黒字・純利益・市場・業種条件で利益上位企業を検索。
| name | type | required | description |
|---|---|---|---|
net_income_min | int | 任意 | 最新期の純利益 (円) 下限 |
consecutive_profit_years | int 1-10 | 任意 | 連続黒字年数の下限 |
market | enum | 任意 | 上場市場 (例: "東証プライム") |
industry_type | string | 任意 | 業種フィルタ |
limit | int 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 件 (枠消費)プレスリリース / 適時開示の活動シグナルから、資金調達・提携・新サービス・採用強化など直近で動きがある法人を検索。
| name | type | required | description |
|---|---|---|---|
signal_types | array<enum> 1-8 | 必須 | funding / ma / product / hiring / office / ipo / security / partnership の組合せ |
date_from / date_to | string YYYY-MM-DD | 任意 | 観測期間。未指定で直近 30 日 |
prefecture | string | 任意 | 都道府県フィルタ |
industry_type | string | 任意 | 業種フィルタ |
business_query | string | 任意 | 業務カテゴリ自然語 (FTS 辞書展開) |
min_strength | int 0-100 | 任意 | シグナル強度の下限 |
min_signal_count | int ≥1 (default 1) | 任意 | 対象期間内に観測されたシグナル数の下限 |
limit | int 1-500 (default 50) | 任意 | 返却件数 |
offset | int 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 で母集団を絞ってから深掘り。