Company

TOOLcompany_search

Find companies by natural-language description — industry, product, business model, supply-chain position.

Coverage: US / CN / JP / HK / KR
Billing: Usage-based · Typically 3–5 cr / call

Input parameters

Parameter	Type	Required	Description
query	string	required	Natural-language company description.
market	string \| string[]	optional	One lowercase value or a list from us, cn, jp, hk, kr. Omit, or pass [], for all five; list order sets no priority.

Example

Arguments

{
  "query": "Japanese factory automation and industrial robot makers",
  "market": "jp"
}

Response

{
  "query": "Japanese factory automation and industrial robot makers",
  "results": [
    { "ticker": "6954.T", "company_name": "Fanuc Corporation",
      "reason": "Develops, manufactures, and sells robots for automated production systems." },
    { "ticker": "6506.T", "company_name": "YASKAWA Electric Corporation",
      "reason": "Manufactures industrial robots and motion control for factory automation." },
    { "ticker": "6861.T", "company_name": "Keyence Corporation",
      "reason": "Manufactures and sells factory automation sensors and electronic control equipment." }
  ],
  "matched_total": 43,
  "returned": 43,
  "output_mode": "full",
  "truncated": false
}

Trimmed: Three of the 43 results shown.

Limits

Limit	Value	Past it
Results per call	All matches	—
Response size	48 KB (~16k tokens)	Reasons shortened, then names dropped; tickers always kept
Calls per day	20 Free · 100 Plus · 500 Ultra · unlimited Enterprise	Fails until 00:00 UTC

Errors

Invalid arguments are refused before the tool runs; the rest arrive as a tool failure whose text is the message. The four shapes are on MCP server.

When	You get	Do
No match	results: [], matched_total: 0	Loosen the description
Daily ceiling hit	"Daily limit reached for company_search: <used>/<limit>"	Wait for the reset, or upgrade
market not in us / cn / jp / hk / kr	Invalid arguments	Use a listed value

Notes

For a list of companies by description only. Numerical screening — revenue, margins, growth — is a run_sql query over company_snapshot.
Every match is returned. When the full list would exceed the MCP response budget, the server drops reasons, then names, rather than rows; output_mode says which shape you received.

Endpoint, client setup and billing are common to all tools. For details, please refer to MCP server.