@pipeworx/gbizinfo
Connect: https://gateway.pipeworx.io/gbizinfo/mcp · Install: one-click buttons
Tools: 5
Japanese corporate registry — company profiles, government procurement awards, subsidies, patents, certifications, financials and workplace disclosure, keyed on the 13-digit 法人番号 (corporate number). Source: gBizINFO, Ministry of Economy, Trade and Industry (METI).
Tools
gbiz_company_search(name?, prefecture?, city?, corporate_type?, has?, capital_min?, capital_max?, employees_min?, employees_max?, founded_year?, limit?, page?, _apiKey)— find companies and their corporate numbers.gbiz_company_profile(corporate_number, _apiKey)— registry profile: legal name, kana and romanised forms, address, representative director, capital, headcount, establishment date, business summary, website, dissolution.gbiz_company_procurement(corporate_number, limit?, _apiKey)— Japanese government contracts awarded: order date, title, amount in yen, awarding ministry.gbiz_company_subsidies(corporate_number, limit?, _apiKey)— subsidies and grants received: approval date, programme, amount, granting ministry.gbiz_company_records(corporate_number, kind, limit?, _apiKey)—patent,certification,commendation,financeorworkplace.
Auth
BYOK. There is no platform key, and platformKeyEnv is deliberately not declared — the gateway sinks a _apiKey tool with no platform key from routing, so questions about Japanese companies get an honest no_match rather than being routed to a tool that can only refuse. Declaring platformKeyEnv before the secret exists would un-sink routing while the key is still missing; secret and env wiring belong in the same later change (the fda-inspections precedent, fleet #617).
Register free at https://info.gbiz.go.jp/hojin/various_registration/form. A non-Japanese applicant can register: the form’s 利用者区分 radio offers 法人担当者 (corporate — wants a 13-digit 法人番号, Japanese company name, department, postcode, address and phone) and 個人利用者 (individual), for which the required fields are just email, password, purpose and the two consent boxes. This is the distinction that makes gBizINFO usable where the NTA 法人番号 API is not — that one’s application path requires a Japanese corporate number with no individual alternative. The token arrives by email.
The public OpenAPI document at https://api.info.gbiz.go.jp/hojin/v3/api-docs?group=v2 embeds a token in info.description. The same sentence says, in Japanese, that it is for checking behaviour on the Swagger page only. It is useful for reading response shapes while building. It is not a credential to ship, and this pack does not carry it.
Upstream behaviour worth knowing
- A missing token is HTTP 500, not 401. Omit the header and gBizINFO answers
500 - Internal Server Error.; a wrong token answers a clean 401. Passed through, a missing credential reads as an upstream outage. Translated to an auth refusal here. - The host is
api.info.gbiz.go.jpand the version is v2. The bareinfo.gbiz.go.jpanswers/hojin/v1/...with the same 500/401 signature, so it looks like a working base until you try v2 there and get an HTML 404. - No results is HTTP 404 — the same status and the same body as a corporate number that does not exist and as a malformed one. On a search that means zero matches, which is a normal answer; only a by-number lookup may report it as not-found.
- The response carries no total. The envelope is
{id, errors, message, hojin-infos}and nothing else — no count, no next-page marker.limitcaps at 5000 andpageat 10. Nothing here claims a total it was not given; a search reportsmore_pages_possibleinstead. - A 200 with an empty array is the normal way of saying a real company has none of that record type. Toyota’s
/subsidyis empty. Don’t use a company like that as a smoke test — it banks a passing test that proves nothing.苫小牧市(1000020012131) has 61 subsidies.
The trap that bites callers, not builders
A Latin-script name search does not find the company you mean. name=Toyota matches the romanised name field, which most Japanese companies leave empty and which is dominated by municipal bodies — it returns 豊田市稲橋財産区 (“Toyota City Inahashi property ward”), not トヨタ自動車株式会社, with a clean 200. name=トヨタ自動車 returns the carmaker. The tool description says so, and a Latin-script query comes back with a match_note saying which field it actually matched. For a specific company the corporate number is the reliable key.
Data sources
- REST API v2:
https://api.info.gbiz.go.jp/hojin/v2/— spec athttps://api.info.gbiz.go.jp/hojin/v3/api-docs?group=v2, Swagger UI at https://api.info.gbiz.go.jp/hojin/swagger-ui/index.html?urls.primaryName=v2 - Publisher: 経済産業省 / METI (corporate number 4000012090001), https://info.gbiz.go.jp/
Tools
- gbiz_company_search — Find Japanese companies and their 13-digit corporate numbers (法人番号) in gBizINFO, the Japanese government corporate registry run by METI. Search by company name, prefecture, corporate form, capital, em
- gbiz_company_profile — Registry profile for one Japanese company by its 13-digit corporate number (法人番号), from gBizINFO (METI). Returns the Japanese legal name, kana and romanised forms, registered address and postcode, rep
- gbiz_company_procurement — Japanese government contracts awarded to one company, by its 13-digit corporate number, from gBizINFO (METI). Each award returns the order date, the contract title, the amount in yen and the ministry
- gbiz_company_subsidies — Japanese government subsidies and grants received by one company, by its 13-digit corporate number, from gBizINFO (METI). Each record returns the approval date, the subsidy programme name, the amount
- gbiz_company_records — Patents and trademarks, statutory certifications, government commendations, filed financial results, or workplace statistics for one Japanese company, by its 13-digit corporate number, from gBizINFO (
Tools
-
gbiz_company_procurement— Japanese government contracts awarded to one company, by its 13-digit corporate number, from gBizINFO (METI). Each award returns the order date, the contract title, the amount in yen and the ministry -
gbiz_company_profile— Registry profile for one Japanese company by its 13-digit corporate number (法人番号), from gBizINFO (METI). Returns the Japanese legal name, kana and romanised forms, registered address and postcode, rep -
gbiz_company_records— Patents and trademarks, statutory certifications, government commendations, filed financial results, or workplace statistics for one Japanese company, by its 13-digit corporate number, from gBizINFO ( -
gbiz_company_search— Find Japanese companies and their 13-digit corporate numbers (法人番号) in gBizINFO, the Japanese government corporate registry run by METI. Search by company name, prefecture, corporate form, capital, em -
gbiz_company_subsidies— Japanese government subsidies and grants received by one company, by its 13-digit corporate number, from gBizINFO (METI). Each record returns the approval date, the subsidy programme name, the amount