Nyt

@pipeworx/nyt

New York Times Developer APIs：記事検索、セクション別のトップストーリー、ベストセラー リスト、映画レビューを、見出し、要約、署名、nytimes.com の URL として提供します。

Pipeworx の一部です — AI エージェントを1683以上の稼働中のデータソースにつなぐMCPゲートウェイです。

ツール

• search_articles(query, page?, begin_date?, sort?) — NYT記事の全文検索（Article Search API）です。1ページあたり10件で、デフォルトでは新しい順です。 ゲートウェイでは nyt_search_articles として公開されます（8つのパックが search_articles をエクスポートするため、単独の名前では曖昧です）。
• top_stories(section?) — セクション（home、world、business、technology、science、health、sports、 arts、…）の現在のトップストーリーです。
• books_bestsellers(list?) — リスト名（hardcover-fiction、hardcover-nonfiction、 combined-print-and-e-book-fiction、…）ごとの現在のベストセラーリストです。順位、タイトル、著者、出版社、ランクイン週数を返します。
• movie_reviews(query?, critics_pick?) — NYTの映画レビューです。オプションでCritics' Picksに絞り込めます。

認証

プラットフォームキー（PLATFORM_NYT_KEY）を使用し、_apiKey でBYOによる上書きが可能です。キーは api-key クエリパラメーターとして送信されます。APIごとの上流の制限（ポータルFAQ #11）は、 1日あたり500リクエスト、1分あたり5リクエストです。このパックにはバックオフがないため、 エージェントのループを短い間隔で実行すると、1分あたりの上限に達する可能性があります。

ライセンス条項（2026-09-14閲覧、fleet #1977；2026-09-15解決、fleet #1980）

NYT APIの利用規約では非商用利用のみが認められており、ポータルFAQでは 「商用」には「現在または将来、有料または有料プランを提供するアプリケーション内で当社のコンテンツを 使用すること」が含まれると定義されています。また、「コンテンツを含むアーカイブ済みまたはキャッシュ済みのデータセットを 他の個人または法人に提供すること」も禁止され、キャッシュは24時間以内に制限されます。ブランドガイドでは、 コンテンツを表示する箇所すべてに「Data provided by The New York Times」（またはTimes APIロゴ）を表示し、 見出しとリンクを改変しないことが求められています。条項の全文、バケット判定、トラフィック数値は docs/data/vendor-tos-audit.md（2026-09-14の追補）に記載されています。NYTコンテンツのミラーや取り込みを追加せず、 利用規約を再確認しないでください。ポータルページはJavaScriptシェルで、テキストは /portals/api/sites/nyt-apigeex-prd-devportal/liveportal/page/terms から配信されています。

2026-09-15に解決：BruceはNYT Licensingに書面で許可を求める代わりに、 zero-rate-attribute を選択しました。ゲートウェイのパックエントリーには zeroRated: true（0クレジット、pricing-v2の段階進行なし）が設定され、すべてのツール応答には attribution フィールドが含まれます — 「Data provided by The New York Times (developer.nytimes.com). Non-commercial use only under the NYT Developer Terms of Use; Pipeworx charges nothing for this data.」。これは誠意を示すものであり、 コンプライアンスを意味するものではありません。NYTのFAQでは今も有料プランのアプリを商用とみなしており、 §1(e)(v)では「直接的な商業的または金銭的利益を目的とするかどうかを問わず」アクセスを共有するには、 引き続き書面による許可が必要です。2026-08-18にはguardian/last-fm/watchmode/acledについても同じ対応が すでに承認されています。Bruceによる新たな決定がない限り、どちらの仕組みも削除しないでください。

データソース

• https://api.nytimes.com/svc/search/v2/articlesearch.json — 記事検索。
• https://api.nytimes.com/svc/topstories/v2/{section}.json — トップストーリー。
• https://api.nytimes.com/svc/books/v3/lists/current/{list}.json — 書籍。
• https://api.nytimes.com/svc/movies/v2/reviews/search.json — 映画レビュー。
• https://developer.nytimes.com/ — ポータル、利用規約（/terms）、帰属表示ガイド（/branding）、FAQ（/faq）。

クイックスタート

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

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

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

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

MCP クライアントがなくても、HTTP 経由で呼び出せます

curl -X POST https://gateway.pipeworx.io/v1/tools/nyt_search_articles \
  -H 'Content-Type: application/json' \
  -d '{"query":"climate change","sort":"newest"}'

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

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

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

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

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

npx -y @pipeworx/mcp-nyt

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

ask_pipeworx の使用

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

ask_pipeworx({ question: "your question about Nyt data" })

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

詳細

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

ライセンス

MIT