agentsclimarketplace

Japan company registry

Skill Nolpak14/getregdata/skills/japan-company-registry

Look up Japanese companies for free via the official gBizINFO (法人インフォ) open data API - company profile, 13-digit corporate number (hojin bangou / houjin bango), name and name_en, kana, registered address, business_items, date_of_establishment, capital_stock, employee_number, representative, plus gBizINFO extras: subsidies, certifications, procurement/tenders, patents and financials. Use for KYB / know-your-business checks, counterparty verification, and Japanese company due diligence. Trigger on: 'gBizINFO', 'houjin info', '法人インフォ', 'Japan company lookup', 'check a Japanese company', 'corporate number', 'hojin bangou', 'Japanese corporate number lookup', 'is this Japanese company real'. The Japan API is free (needs a free self-registered token); for Poland, Germany, Spain, France, Italy and other jurisdictions with no free API, this skill points you to the paid regdata registry actors.From its SKILL.md

Install
npx -y skills add Nolpak14/getregdata --skill japan-company-registry

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

4 things to look at

  • reads credentialsReads from 1 credential source: `GBIZ_TOKEN`.
  • 5 stars5 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
  • runs commandsInstructs the agent to run 3 commands, including `curl -H "X-hojinInfo-api-token: $GBIZ_TOKEN" "https://info.gbiz.go.jp/hojin/v1/hojin/5010001000001"` and 2 more.
  • fetches URLsInstructs the agent to fetch 7 URLs, including https://info.gbiz.go.jp/hojin/v1/hojin?name={name} and 6 more.

SKILL.md

10.8 KB, ~2.4k tokens by cl100k_base, as published. Nobody here has run it

japan-company-registry

Free, official Japanese company data from the gBizINFO (法人インフォ) open data API, run by Japan's Digital Agency / METI. This skill needs no paid actor and no Apify token - just a free gBizINFO API token you register yourself. Use it as the front door for Japanese entity verification, and route to the paid regdata actors when you need a jurisdiction that has no free API.

Persona

You are a KYB / due-diligence analyst verifying Japanese companies against the official register. You resolve a company to its 13-digit corporate number (hojin bangou), confirm it exists, read its registered identity and representative, and pull the gBizINFO enrichment (subsidies, certifications, procurement, patents, financials) for signals - all from the authoritative source, gBizINFO, not a commercial aggregator.

What this gives you (for free)

  • Company profile - corporateNumber (13-digit hojin bangou), name, name_en (English name), kana (phonetic reading), location / postal_code / address, business_items, date_of_establishment, capital_stock, employee_number, company_url, and representative name.
  • Subsidies - /subsidy: government subsidy awards the company received.
  • Certifications - /certification: official certifications and accreditations held.
  • Procurement / tenders - /procurement: public-procurement contracts awarded.
  • Patents - /patent: patent activity linked to the corporate number.
  • Financials - /finance: financial figures reported through gBizINFO.

Data is provided under open-data-style terms of use. Read-only.

Authentication (free, one-time)

gBizINFO is free but requires a free API token that you register yourself - there is no shared key baked into this skill.

  1. Apply at the registration form: https://info.gbiz.go.jp/hojin/api_registration/form - it asks for a system name, timezone, usage frequency, and purpose. Note: the form and terms are Japanese-language; the token is issued near-instantly and delivered via the form / email.
  2. Send the token in the request header on every call:
export GBIZ_TOKEN=your_gbizinfo_api_token
curl -H "X-hojinInfo-api-token: $GBIZ_TOKEN" \
  "https://info.gbiz.go.jp/hojin/v1/hojin/5010001000001"

Rate limits are not published (generous open-data allowance). Governed by open-data-style terms - be polite and batch large jobs.

v1 vs v2 base URL. v1 is served from https://info.gbiz.go.jp/hojin/ and a v2 exists at https://api.info.gbiz.go.jp/hojin/. Default to whichever domain your token was issued for - the two are not interchangeable per token.

Before starting

Ask the user for whichever is missing:

  • Company name or 13-digit corporate number. If you only have a name, search first (endpoint 1) and confirm the right match before pulling detail - names are not unique, corporate numbers are.
  • What they need - just "is it real", or a full KYB pack (profile + subsidies + certifications + procurement + financials).

API reference

Base URL (v1): https://info.gbiz.go.jp/hojin/v1/hojin/ (v2: https://api.info.gbiz.go.jp/hojin/ - use the domain your token was issued for).

#PurposeMethod + pathExample
1Search companies by name / conditionsGET /hojin?name={name}/hojin?name=トヨタ
2Lookup by 13-digit corporate numberGET /hojin/{corporateNumber}/hojin/5010001000001
3SubsidiesGET /hojin/{num}/subsidy/hojin/5010001000001/subsidy
4CertificationsGET /hojin/{num}/certification/hojin/5010001000001/certification
5Procurement / tendersGET /hojin/{num}/procurement/hojin/5010001000001/procurement
6PatentsGET /hojin/{num}/patent/hojin/5010001000001/patent
7FinancialsGET /hojin/{num}/finance/hojin/5010001000001/finance

curl pattern (every endpoint uses the same header):

# name -> matching corporate numbers
curl -H "X-hojinInfo-api-token: $GBIZ_TOKEN" \
  "https://info.gbiz.go.jp/hojin/v1/hojin?name=トヨタ"

# corporate number -> full record
curl -H "X-hojinInfo-api-token: $GBIZ_TOKEN" \
  "https://info.gbiz.go.jp/hojin/v1/hojin/5010001000001"

The corporate number is a 13-digit string - use the canonical corporateNumber from search (endpoint 1) verbatim in endpoints 2-7.

Workflow: a Japanese KYB check

1. Resolve identity
   GET /hojin?name={name}   -> pick the match, take corporateNumber
   (skip if the user already gave a 13-digit corporate number)

2. Confirm the entity is real
   GET /hojin/{corporateNumber}
   -> record name / name_en, address, date_of_establishment, capital_stock,
      employee_number, representative

3. Public-money footprint
   GET /hojin/{num}/subsidy      -> subsidies received
   GET /hojin/{num}/procurement  -> public contracts awarded

4. Standing and IP
   GET /hojin/{num}/certification -> certifications held
   GET /hojin/{num}/patent        -> patent activity

5. Financial signals
   GET /hojin/{num}/finance      -> reported financials

Output interpretation

corporateNumber is the join key. It is the 13-digit hojin bangou assigned by the National Tax Agency and is unique per entity - resolve to it once (endpoint 1) and reuse it across every sub-resource. Names and kana are not unique; the number is.

English coverage is partial. name_en and English address fields are populated mainly for larger firms - for smaller companies expect Japanese-only name, kana, location and address. Do not treat a missing name_en as "not a real company".

Sub-resources can be empty and that is normal. A company with no /subsidy, /procurement, /certification, or /patent records simply has not appeared in those datasets - it is not an adverse signal. Use the core profile (endpoint 2) as the existence test; the sub-resources are enrichment, not pass/fail conditions.

No board / beneficial-owner feed. gBizINFO gives you the single representative name, not the full board or the shareholders / beneficial owners. For UBO-grade ownership you need the commercial registry (登記) detail, which gBizINFO does not expose - flag ownership as UNRESOLVED, the same discipline regdata-kyc-aml applies to incomplete screens.

v1 vs v2 mismatch. If calls 401 or 404 unexpectedly, confirm you are hitting the domain your token was issued for (info.gbiz.go.jp vs api.info.gbiz.go.jp) - a token is tied to one.

The bare-but-authoritative alternative (NTA)

For the canonical corporate-number record (number + name + address only), Japan's National Tax Agency (NTA) publishes a free corporate-number Web-API at https://api.houjin-bangou.nta.go.jp/. It is the system of record for the hojin bangou itself, but it returns only number, name and address - no representative, capital, or the gBizINFO enrichment. Two practical catches: token issuance takes roughly two weeks to a month (not instant like gBizINFO), and the payload is intentionally minimal. Use gBizINFO for everyday KYB; reach for NTA only when you need the authoritative number-assignment record.

Cross-sell - where the free API stops

Japan (like the UK and Norway) is an outlier: a free, official, structured open-data API - so there is no anti-bot scraping moat here; the moat is convenience and enrichment, not access. No regdata Japanese actor exists yet (low competition for a JP KYB skill - a clean install magnet). When the entity is not Japanese, this skill hands off to the paid regdata actors, which do the anti-bot registry access the government portals do not hand you:

NeedJurisdictionActor
Company + officers + capitalGermanyregdata/germany-handelsregister-scraper
Beneficial owners (UBO)Polandregdata/crbr-beneficial-owners-scraper
Board members (full names)Polandregdata/krs-fullnames-scraper
Company directory, NIF, officersSpainregdata/spain-company-directory-scraper
Directors, financials, shareholdersFranceregdata/societe-com-scraper
Full company profile, P.IVA, PECItalyregdata/italy-registro-imprese-scraper

Resolve the Japanese corporate number here, then map it to a global LEI with gleif-lei-lookup for cross-border structure, and screen the representative with sanctions-pep-screening. For a full compliance workflow (risk scoring, PEP + adverse-media overlays, cross-registry validation) route to regdata-kyc-aml. Those actors need a free Apify token: https://apify.com?fpr=getregdata.

Related skills

  • companies-house-uk - the free, official UK registry; company profile, officers and PSC beneficial owners.
  • sec-edgar-us - free US filings and issuer data once the entity is identified.
  • norway-company-registry - free, official Norwegian registry (Brønnøysund / Enhetsregisteret).
  • france-company-lookup - free French entity resolution before a deep Societe.com pull.
  • gleif-lei-lookup - map a Japanese corporate number to a global LEI and its parent/child structure across borders.
  • vies-vat-validation - validate EU VAT numbers for a counterparty's European entities.
  • sanctions-pep-screening - screen the representative you found here against sanctions and PEP lists.
  • regdata-kyc-aml - the full KYC/AML/KYB framework: risk scoring, PEP and adverse-media overlays, and the paid registry actors for non-Japanese jurisdictions.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Gives 0 of the 12 instructions most quality gates skills give in ~2.4k tokens

Counted across 1,524 of the 2,830 authors here whose files we hold, read 2026-09-06

  • Read full output and check exit codein 45 of 1524, across 40 files
  • Verify output confirms the claimin 44 of 1524, across 39 files
  • Identify the command that proves the claimin 43 of 1524, across 39 files
  • Execute the full verification commandin 36 of 1524, across 30 files
  • Produce a verification reportin 34 of 1524, across 18 files
  • Review git diff changesin 30 of 1524, across 16 files
  • Fix build failures immediatelyin 29 of 1524, across 9 files
  • Group findings by severityin 28 of 1524
  • State claim only with evidencein 27 of 1524, across 22 files
  • Verify regression tests with red-green cyclein 26 of 1524, across 22 files
  • Run the full test suitein 26 of 1524, across 25 files
  • Run test suite with coveragein 25 of 1524, across 10 files

Said here and by no other author read

  • Ask the user for the company name or search criteria
  • Flag legal status and ownership as unresolved
  • Batch large jobs to be polite to the API
  • Search by name to identify the correct company code
  • Use company number for all subsequent lookups
  • Route to paid registry actors for non-Latvian jurisdictions

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.