Analyst Ratings

@pipeworx/analyst-ratings

本日の米国株アナリストによる格上げ、格下げ、カバレッジ開始、目標株価の変更を市場全体から確認できます。また、米国の任意のティッカーについて、現在のコンセンサス評価とカバレッジを担当する証券会社の一覧を確認できます。

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

ツール

• analyst_upgrades_today(action?, symbol?, us_only?, limit?) — この取引セッション中にウォール街の証券会社が発表したすべての評価変更を確認できます。ティッカー、企業名、取引所、証券会社、アナリスト、変更前と変更後の評価、変更前と変更後の目標株価を含みます。「今日格上げされた銘柄」「今日のアナリストによる格下げ」「本日の目標株価の変更」「アナリストがカバレッジを開始した銘柄」などの質問に答えます。action は all（デフォルト）、upgrade、downgrade、initiated、price_target、reiterated のいずれかです。
• analyst_ratings_for_symbol(symbol) — コンセンサス評価（Buy／Hold／Sell）、その銘柄をカバーするアナリストの人数、推奨を発表している証券会社の一覧を確認できます。「NVDAについてアナリストはどう考えていますか」「Appleを担当しているのはどの証券会社ですか」などの質問に答えます。

認証

キーは不要です。どちらの上流サービスも公開されており、認証情報、登録、プランなしで利用できます。

データソース

• https://www.marketbeat.com/ratings/ — 日次評価をまとめたテーブル（約400行、HTMLで約2 MB）。また、同じテーブルを1つのアクションに絞り込んだ /ratings/upgrades/、/ratings/downgrades/、/ratings/initiations/ もあり、サイズは約10分の1です。action で1つのアクションを選択すると、パックは絞り込まれたページを使用するため、一般的なクエリで2 MBを取得することはありません。
• https://api.nasdaq.com/api/analyst/{SYMBOL}/ratings — 銘柄ごとのコンセンサス情報：meanRatingType、ratingsSummary、brokerNames[]。

注意点

• api.nasdaq.com はブラウザー以外の User-Agent に 520 を返します。 2026-09-10 にデプロイ済みの Cloudflare Worker から測定：PipeworxBot/1.0 (+https://pipeworx.io) → 65 ms で 520、Mozilla/5.0 (pipeworx.io) → 200。520 は Cloudflare の汎用オリジンエラーなので、リクエスト拒否ではなく障害のように見えます。このパックでは、カタログのほかの部分ですでに使用されている Mozilla/5.0 (pipeworx.io) 形式を送信します。
• Nasdaq エンドポイントの upgradesDowngrades[] は常に空です。 2026-09-10 に AAPL、AMGN、NVDA、TSLA、AAL で確認したところ、その朝に実際に格下げされた銘柄を含め、すべて [] を返しました。このフィールドは機能していません。その日のアクションを含むかのように表示しないでください。このデータは analyst_upgrades_today にあります。
• どちらのソースにも日付セレクターはありません。 https://www.marketbeat.com/ratings/?date=... は 200 を返しますが、パラメーターは黙って無視されます。/ratings/2026/09/09/ と /ratings/9/9/2026/ は 404 です。テーブルにも行ごとの日付はありません。したがって、どちらのツールも現在のセッションのみを対象とし、as_of は取得時点の米国／東部時間の日付から、週末の場合は日付を戻して導出されます。ソースが示していない日付を提示するのではなく、ペイロードの as_of_basis にその旨を記載しています。市場休場日は調整されません。
• 統合された /ratings/ フィードは米国のみではありません。 2026-09-10 の測定では、NYSE 178、NASDAQ 177、TSE 14、OTCMKTS 13、LON 13、NYSEAMERICAN 3、CVE 3 の計 402 行でした。質問の対象は米国株であるため、us_only はデフォルトで true に設定され、トロントとロンドンの上場銘柄を除外します。
• セルのテキストではなく data-clean を解析してください。 すべてのセルには data-clean="old|new" 属性があり、AAPL|Apple、$445.00|$425.00、Buy|Hold のような値が入っています。一方、レンダリングされたテキストはロゴ、星評価、アップセルリンクで囲まれています。アクションは 2 つ目のセルの data-sort-value にあります。目標株価がない場合は空文字列ではなく 0 なので、明示的に null にマッピングしないと、目標株価が $0 と表示されます。
• MarketBeat には、正規の Mozilla/5.0 (compatible; PipeworxBot/1.0; +https://pipeworx.io) UA で Cloudflare Worker のエグレスからアクセスできます（200、212 KB、187 ms。2026-09-10 に wrangler dev --remote から測定）。Cloudflare 自体の背後にあるため、構築前に確認する価値がありました。

クイックスタート

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

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

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

https://gateway.pipeworx.io/analyst-ratings/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 も同じゲートウェイと同じ 1872 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合は、HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/analyst_upgrades_today \
  -H 'Content-Type: application/json' \
  -d '{"action":"upgrade","limit":10}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/analyst_upgrades_today を使用します。ツールを見つけるには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

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

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

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

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

npx -y @pipeworx/mcp-analyst-ratings

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

ask_pipeworx を使用する

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

ask_pipeworx({ question: "your question about Analyst Ratings data" })

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

詳細

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

ライセンス

MIT