德州企业查询(Comptroller 特许税登记)
按企业名称、11 位 Comptroller 纳税人号、9 位联邦 EIN 或 6-10 位州务卿档案号批量查询德州 LLC/公司/LP 的官方特许税账户记录:营业权状态(right to transact)、SOS 登记状态与日期、SOS 档案号、组建州、注册代理人及注册办公室、邮寄地址、最新 Public Information Report 年度的董监高名单(姓名/职务/年度/地址)。数据源为德州审计官官网公开 JSON API(搜索页同源),无需账号、无需代理
概览
按企业名称、11 位 Comptroller 纳税人号、9 位联邦 EIN 或 6-10 位州务卿(SOS)档案号查询德州 LLC/公司/LP 的官方特许税账户记录。数据源为德州审计官官网公开 JSON API(comptroller.texas.gov/data-search/franchise-tax,与官网 Taxable Entity Search 页面同源),无需账号、无需代理。
输入
| 字段 | 类型 | 默认 | 说明 |
|---|---|---|---|
query | string | — | 快速单查:具体企业名(如 Dell Inc)。宽泛词会被源站拒绝 |
searchTerms | string(每行一个) | — | 批量企业名搜索;非空时覆盖 query |
taxpayerNumbers | string(每行一个) | — | 11 位纳税人号或 9 位 EIN,如 17424878340 / 742487834 |
fileNumbers | string(每行一个) | — | 6-10 位 SOS 档案号,如 0007444706 |
fetchDetails | boolean | true | true = 每条结果额外调详情(董监高/代理人/完整地址);false = 只返回基础行(名称/纳税人号/邮编) |
maxResults | integer | 1000 | 全部查询合计上限(1-10000),达到后剩余查询跳过 |
所有搜索字段为空时,按源站文档约定返回示例纳税人号(Dell Inc)单条记录。
输出
每行一个实体,扁平结构:
- 基础(总是返回):
taxpayerId、name、sourceUrl、fetchedAt、mailingAddressZip(基础模式) - 详情模式追加:
dbaName、feiNumber、邮寄地址 5 字段、rightToTransactTX、stateOfFormation、sosRegistrationStatus、effectiveSosRegistrationDate、sosFileNumber、注册代理人 + 注册办公室 4 字段、reportYear、officers(每行"职务 | 姓名 | 年度 | 地址")与officersJson
使用建议
- 名称搜索用具体名称:宽泛关键词(如
the)会被源站以 "Search will return N entries" 拒绝,该查询跳过并记入日志。 - 每次名称查询源站一次性返回全部匹配(如
Tesla≈ 187 条),maxResults在本地截断。 rightToTransactTX=ACTIVE指特许税账户状态良好,不等于州务卿 legal good standing 证书。- 董监高名单来自实体最新申报的 Public Information Report 年度。
边界说明
- 仅覆盖已登记特许税的实体(LLC/公司/LP/专业协会/金融机构等),不含个体户。
- 详情页与搜索接口同源、免登录;单条查询失败只影响该条,运行继续。
适用边界
数据源为 comptroller.texas.gov 官方免登录 JSON API(与官网搜索页同源),仅覆盖已登记特许税的实体(LLC/公司/LP/专业协会等),不含个体户;'营业权 ACTIVE' 指特许税账户状态,不等同于州务卿 legal good standing 证明;宽泛关键词会被源站拒绝(日志中体现并跳过);每次查询源站一次性返回全部匹配(无分页),maxResults 本地截断;批量输入字段每行一个(兼容数组)
- 适合用于
- KYB/供应商核验:确认德州实体特许税账户是否 ACTIVE、有无营业权
- 按 EIN/纳税人号/档案号反查企业全名、SOS 登记日期与组建州
- 销售线索/诉讼送达:拿注册代理人、注册办公室与最新年度董监高名单
- 不要用于
- 个体户(sole proprietor)——未登记特许税的实体不在源数据内
- 需要官方 good standing 证书(须向州务卿申请 Certificate of Fact)
- 德州以外州的企业登记查询
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1单条查询失败只影响该条:记录日志并继续,不中断运行
- 2源站拒绝宽泛关键词(Search will return N entries)时该查询跳过并在状态中列出
- 3详情调用失败时保留搜索基础行(name/taxpayerId/邮编),不丢结果
- 4全部搜索字段为空 → 按文档约定返回示例纳税人号(Dell Inc)单条记录
输入参数
调用本 Data App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 单次搜索企业名
query选填string快速单查:具体企业名(如 'Dell Inc')。宽泛词会被源站拒绝,请用具体名称;searchTerms 非空时本字段被覆盖 - 企业名搜索(批量)
searchTerms选填string每行一个(多行文本):按企业名批量搜索,如 'Tesla'、'H-E-B Grocery';非空时覆盖 query - 纳税人号 / EIN(批量)
taxpayerNumbers选填string每行一个(多行文本):11 位 Comptroller 纳税人号或 9 位联邦 EIN,如 17424878340 / 742487834 - TX SOS 档案号(批量)
fileNumbers选填string每行一个(多行文本):6-10 位德州州务卿档案号,如 0007444706 - 抓取完整详情
fetchDetails选填booleantrue(默认)= 每条结果额外调用详情接口拿董监高/代理人/地址;false = 只返回基础行(企业名、纳税人号、邮编)默认值true示例true - 最大结果数
maxResults选填integer全部查询合计的记录上限(1-10000,默认 1000);达到上限后剩余查询跳过范围1–10000默认值1000示例1000
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- Comptroller 纳税人号
taxpayerIdstring11 位德州 Comptroller 纳税人号(唯一 ID) - 企业名称
namestring企业名称 - DBA 名称
dbaNamestring经营别名(Doing Business As),仅详情模式返回 - 联邦 EIN
feiNumberstring9 位联邦雇主识别号,仅详情模式返回
调用方式
本 Data App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 Data App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 Data App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=SpiderByte/texas-business-leads",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制配置提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(默认引导你登录授权,不会让你把 API Key 发在对话里)。
如需在同一个 MCP 连接里指定多个 Data App,前往 MCP 连接页(已为你指定本 Data App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。