統編查公司
twtools-lookup_company_by_tax_id
TW 전용MIT외부 API
타사 API (예: MOEAIC 사업자 등기)에 의존 — 업스트림 다운타임, 레이트 제한, 포맷 변경으로 실패할 수 있음. 다른 Tier A 순수 함수 도구에는 영향 없음.
以統一編號查詢公司登記資料(經濟部商業司開放 API)。
Args:
tax_id: 8 位統一編號。
Returns: 公司名 / 狀態 / 負責人 / 登記地址 / 主管機關 / 資本額 /
設立日 (ISO) / 最後變更日 (ISO)。raw 內保留原始 OData 欄位。
⚠ Tier B:實際打外部 API(data.gcis.nat.gov.tw OData v3)。可能因
upstream 停機、rate-limit、format 異動而 fail。返回 found=False 並
附 reason 而不是丟例外。입력 스키마
{
"properties": {
"tax_id": {
"title": "Tax Id",
"type": "string"
}
},
"required": [
"tax_id"
],
"title": "lookup_company_by_tax_idArguments",
"type": "object"
}호출 방법
Twinkle Hub MCP 클라이언트가 설정되면 에이전트는 twtools-lookup_company_by_tax_id을 봅니다. 호출을 요청하기만 하면 — 예시:
# Ask Claude / any MCP client: 請用 twtools-lookup_company_by_tax_id 處理 "…"。 # It will call: twtools-lookup_company_by_tax_id(input="…")
아직 클라이언트를 설정하지 않으셨나요?
Claude Desktop은 3 분이면 연결 — .mcpb 다운로드 후 더블 클릭, 다른 클라이언트는 docs 참조.
사용자 문서 보기