Sos Entities

@pipeworx/sos-entities

米国各州の事業体登記簿（Secretary of State）を、正規化された形式でまとめています。Florida、New York、Colorado、Oregon、Connecticut、Pennsylvaniaを対象とし、TexasについてはComptrollerのフランチャイズ税登録を通じて対応しています。各レコードには、事業体番号、正式名称、種類、ステータス、設立日、主たる住所、登録代理人が含まれます。州が公開している場合は、役員の氏名と役職も含まれます。設立フィードには、指定した日付以降に州内で設立された新しい事業体が表示されます。認証情報は不要です。

Pipeworxの一部です。AI エージェントを1855以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携関係になく、同社の承認を受けておらず、同社から公開されたものでもありません。

ツール

• sos_search(name, state?, status?, limit?)：会社名で事業体を検索します。クエリで始まる名前を検索し、該当するものがなければ、名前にクエリを含むものを再検索します。7州すべてを一度に検索するには、stateを省略します。各州について、独自のcount、match、data_as_ofが返されます。州の登記簿から応答がなかった場合はstate_errorsに表示され、その場合completeはfalseになります。
• sos_entity(state, entity_number)：1つの事業体について、州が公開している場合はofficers: [{name, role}]を含む完全なレコードを返します。Floridaでは最大6人の役員、Connecticutでは主要責任者、Pennsylvaniaでは記載されているすべての関係者、New Yorkでは会長またはCEO、Oregonでは権限を持つ代表者が返されます。ColoradoとTexasでは役員情報は公開されていません。found: falseは、登記簿から応答があり、その番号に該当する事業体がなかったことだけを意味します。
• sos_new_entities(state, since, name_query?, entity_type?, limit?)：sinceから今日までに設立された事業体を、設立日、続いて事業体番号の順に並べて、新しい順に一覧表示します。将来の日付が発効日となる（発効が遅延する）届出は除外されます。Floridaでは最大70日前までさかのぼり、その他の州では任意の日付を指定できます。新規事業リストの作成や設立状況の監視に使うフィードです。

認証

認証情報は不要です。

個人データ

Bruceは2026-10-08に、役員、取締役、マネージャー、代理人の氏名を役職および情報源とともに提供するという決定PD（「names-and-roles」）を下しました。個人の住所は一切提供せず、取得もしません。

• すべてのSocrataクエリで、取得する列を指定します。
• 個人の住所列はクエリから完全に除外するか、SoQLのcase()で囲み、対象が事業者でない限りnullを返すようにします。
• 登録代理人の住所は、代理人が事業者である場合に限り表示されます。

Floridaの取り込み処理では、解析時に役員の住所を除外します。また、代理人が事業体としてフラグ付けされ、かつ事業体らしい名称である場合に限り、その住所を保持します。Floridaで事業体としてフラグ付けされている代理人の約37%は個人です。

削除依頼は[email protected]までお送りください。氏名はsrc/removals.tsで非表示にしており、すべての州に適用されます。

データソース

• NY：https://data.ny.gov/d/n9v6-gdp6。Department of State の現役法人データです。現役の事業体のみを掲載しています。
• CO：https://data.colorado.gov/d/4ykn-tg5h。Secretary of State のコロラド州事業体データです。すべてのステータスを対象としています。
• OR：https://data.oregon.gov/d/tckn-sxa6。Corporation Division の現役事業者データです。関連する名称（事業所、郵送先住所、登録代理人、権限を付与された代表者）ごとに1行あり、このパックでは行を registry_number でグループ化します。
• CT：https://data.ct.gov/d/n7gp-d28j（Business Master）、https://data.ct.gov/d/ka36-64k6（Principals）、https://data.ct.gov/d/qh2m-n44y（Agents）を内部の business_id で結合します。公開されている事業体番号は accountnumber です。
• TX：https://data.texas.gov/d/9cir-efmm。Comptroller の現役フランチャイズ税納税者データです。これは有料サービスである Texas SOS の登録データベースではありません。種類、ステータス、取引権限のコードは、データセットに添付されている「Franchise Layout.docx」に記載されています。
• PA：https://data.pa.gov/d/xvd7-5r2c。Department of State のペンシルベニア州登録事業者データです。関係者ごとに1行あり、住所は事業者の登録住所です。file.dos.pa.gov の検索ポータルは、自動化されたクライアントに HTTP 999「Security Check」を返します。このオープンデータセットなら Worker からアクセスできます。
• FL：Florida Division of Corporations の公開 SFTP サーバー sftp.floridados.gov。ユーザー名 Public とパスワードは、同局が https://dos.fl.gov/sunbiz/other-services/data-downloads/ で公開しています。四半期ごとの全件ファイル doc/Quarterly/Cor/cordata.zip（約1.8 GB、Deflate64、約1,300万件）と、日次ファイル doc/cor/YYYYMMDDc.txt が提供されています。レコードは1,440バイトの固定幅形式です。レイアウトは scripts/sos-entities/ingest_fl.py に記載されています。

Florida はリアルタイムで照会しません

Sunbiz の検索では、自動化されたクライアントに JavaScript チャレンジが表示されます。Florida の事業体ごとのデータは SFTP ファイルでのみ公開されており、Worker は SFTP を利用できません。.github/workflows/sos-entities-fl-refresh.yml が実行する scripts/sos-entities/ingest_fl.py（日次の届出ファイルと週次の全件ビルド）がファイルを解析し、ゲートウェイのデータセットバケットに格納します。このパックは、検索ごとに gzip 圧縮されたチャンクを1つ範囲読み込みします。全件ビルドより新しい日次ファイルは上書き適用されるため、Florida が新しい届出を公開した当日から検索できます。Florida の応答には、最新の日次ファイルの日付を示す data_as_of が含まれます。ゲートウェイのデータセットバインディングがない場合（npm install のみの場合）、Florida の呼び出しはその旨を示すエラーになります。他の6州は引き続き利用できます。

設計メモ：docs/sos-entities-design.md。

注意点

• data.ny.gov は、URL が約8 KBを超えると HTTP 414 を返します。事業者名のテストは $select 内の住所ごとに繰り返されるため、パターンリストは短くし、各住所は | で結合した1つの列として取得しています。
• Florida の設立日は将来の発効日になることがあります。Colorado と Texas にも2026年後半の日付が含まれています。sos_new_entities は今日までのデータに限定されます。
• NY、OR、PA が公開しているのは現役の事業体のみです。これらの州で status: "inactive" を指定すると、空の結果ではなく state_notes エントリが返されます。
• Florida の人名は固定幅です：姓（20）、名（14）、ミドルネームのイニシャル（1）、サフィックス（7）。サフィックス欄に1文字だけ入っている場合は、ミドルネームのイニシャルが誤った欄に入力されています。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "sos-entities": {
      "url": "https://gateway.pipeworx.io/sos-entities/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/sos-entities/mcp の tools/list は、上の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック固有のツールに加えて、共有ツールが約 30 個表示されます。接続の initialize レスポンスには正確な対象範囲が記載されており、その日の時点での正式な情報です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックでは対応できない質問にも、全カタログを横断する ask_pipeworx 経由で回答できるため、2 つ目の MCP サーバーを追加する必要がありません。現時点では、メタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も同じゲートウェイと同じ 1855+ 個のデータソースに接続します。違いは、どのパックのツールが直接表示されるかだけです。どちらから接続しても、ask_pipeworx ですべてのツールを利用できます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/sos_search \
  -H 'Content-Type: application/json' \
  -d '{"name":"Goldman Sachs & Co","state":"NY","limit":3}'

最初の呼び出しにアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/sos_search を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "sos-entities": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-sos-entities"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-sos-entities

stdin/stdout 経由で MCP を使用し、このパック固有のツールのみについて、initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールを使えますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Sos Entities data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT