Index Constituents

@pipeworx/index-constituents

6つの主要な米国および先進国市場の株式指数について、現在の構成銘柄、ウェイト、セクターを提供します。また、S&P 500の追加・除外を日付付きで記録した履歴も提供します。ライセンス取得済みの指数データフィードではなく、リアルタイムのETFを代理データとして使用して、特定時点の指数構成を示します。

Pipeworx の一部です。AI エージェントを1779以上のリアルタイムデータソースにつなぐMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携関係になく、承認も受けておらず、同社が公開したものでもありません。

ツール

• index_constituents(index, limit?, offset?, sector?) — 1つの指数（sp500、sp400、sp600、russell1000、russell2000、eafe）の現在の株式構成銘柄を返します。ティッカー、名称、GICSセクター、ウェイト、ファンドの「as of」日付が含まれます。ウェイトの降順で並べられます。追跡ETFが保有する現金、担保、先物はここには含まれません（ishares_etf_holdings を参照）。デフォルトの limit は50です。limit: 600（最大値）を指定すると、1回の呼び出しで指数全体を取得できます。約503行のS&P 500の結果は、デフォルトではなく、リクエストに応じて提供されます。
• ishares_etf_holdings(ticker, limit?, offset?, asset_class?) — 6つの追跡ETF（IVV、IJH、IJR、IWB、IWM、EFA）のいずれかについて、報告された全ポジションを返します。現金、担保、先物も含まれ、それぞれに独自の asset_class が付与されるため、株式に暗黙的にまとめられることはありません。
• constituent_changes(index, from?, to?, limit?) — 日付付きのS&P 500への追加・除外を返します（index は sp500 である必要があります。他の5つの指数には、公開されている日付付きの変更履歴テーブルがありません）。from／to には、年のみ（「2024」）またはISO日付を指定できます。

認証

認証キーは不要です。どちらの上流データも、認証不要の公開ページです。

データソース

• iShares（BlackRock） — 各ファンドが、自身の指数連動ETF向けに公開している日次保有銘柄ファイル（IVV／S&P 500、IJH／S&P MidCap 400、IJR／S&P SmallCap 600、IWB／Russell 1000、IWM／Russell 2000、EFA／MSCI EAFE）。これは公式の指数構成データの代理データであり、指数プロバイダー自身のデータではありません。S&PとRussellは構成銘柄ファイルを無料公開していないため、指数に密接に連動するファンドの実際に報告されたポートフォリオが、特定時点の構成を示す公開データとして最も近い代替情報です。ウェイトはETF独自のポートフォリオウェイトであり、S&P／Russellが公表する指数ウェイトではないため、わずかに異なる場合があります（現金によるパフォーマンスへの影響、サンプリング、コーポレートアクションの反映時期など）。
• Wikipedia — 「List of S&P 500 companies」と「Historical components of the S&P 500」（後者は、このパックの constituent_changes の情報源です。1963年以降にS&Pが発表したすべてのS&P 500銘柄入れ替えについて、発効日と公表された理由を記載した、コミュニティが維持する出典付きの表です）。

再利用に関する注記（2026-10-12確認）。 BlackRockのサイト利用規約（blackrock.com/corporate/compliance/terms-and-conditions）では、ウェブサイトのコンテンツは「個人的かつ非商業的な使用のみ」を目的とし、BlackRockの書面による許可なく「公共または商業目的で配布、改変、送信、再利用、再投稿……」してはならないとされています。このパックは保有銘柄ファイルを保存、ミラーリング、再配布しません。各呼び出しでファンドの最新ファイルをライブ取得し（通常のブラウザーと同様、エッジで1日キャッシュされます）、その呼び出し分の解析済み行を返します。プロキシとミラーの区別に関するルール（CLAUDE.md、fleet #1389 —「リクエストごとに上流へライブ呼び出しを行う場合、明示的な許可は不要。大量の複製／ミラーリングにのみ必要」）に従えば、これはプロキシであり、再配布ではありません。このパックにもPipeworx独自のストレージにも、データセットは組み込まれていません。WikipediaのコンテンツはCC BY-SA 4.0であり、出典表示を伴う商用利用を含め、再利用が認められています。すべてのレスポンスの source には、Wikipediaと該当ページが記載されます。

注意事項

• iShares の保有銘柄ファイルは、ファンドによって列の構成が同一ではありません： IJH と IJR には「Type」列が追加され、ウェイト欄は「Weight (%)」ではなく「Market Weight」と呼ばれています。このパックは列の位置ではなくヘッダー名で読み取るため、列の順序が変更されてもデータが誤って対応付けられることはありません。
• 各レスポンスの data_as_of は、Pipeworx がファイルを取得した時刻ではなく、ファイルに記載されたファンド固有の「Fund Holdings as of」日付です。データの鮮度を判断する際に使用してください。
• S&P 500 の保有銘柄ファイルには、ファンドの運用方針上は「全株式」であるにもかかわらず、株式以外の行がいくつか含まれています（現金、担保、リバランスの合間に投資比率を維持するために使われる先物契約など）。これらは index_constituents から除外され、ishares_etf_holdings では明確に分類されています。
• 現時点で constituent_changes が対象としているのは sp500 のみです。他の 5 つの指数には、無料で日付が記載され、出典を明示できる同等の変更テーブルがありません。追加するには、異なる、おそらく有料の情報源が必要になります。

クイックスタート

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

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

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

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

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

このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、フル Pipeworx ゲートウェイに接続します：

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/index_constituents \
  -H 'Content-Type: application/json' \
  -d '{"index":"sp500","limit":600}'

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

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

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

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

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-index-constituents

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

ask_pipeworx を使う

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

ask_pipeworx({ question: "your question about Index Constituents data" })

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

詳細

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

ライセンス

MIT