本文へスキップ
ReviewRamble

週刊ブリーフ

AIのレビューを、あなたの受信箱に。

  • ツール、モデル、MCPサーバー、リポジトリの新しいレビュー(結論を最初に)
  • 変更があったときに再確認した価格と評価
  • 公開された新しい分析記事

モデル、エージェント、MCPサーバー、そして本当に時間をかける価値のあるツール。

週に1通です。配信停止は各メールのリンクからできます。 メールアドレスの利用について

Valyu TypeScript SDK (valyu-js)

Valyu の有料 API(検索、抽出、回答、DeepResearch)向け公式 TypeScript クライアント。コードは MIT、サービスは従量課金です。

レビュー: Sheela · 更新

GitHubで見る 従量課金

当サイトの評価

3.8/5

有料 API 1 本のための丁寧で更新の速いクライアントです。コードは MIT ですが、実際に買っているのは Valyu のクレジットメーターです。

Valyu TypeScript SDK (valyu-js)とは?

valyu-js は、AI エージェント向けの検索 API である Valyu の公式 TypeScript/JavaScript クライアントです。1 つの `Valyu` オブジェクトで、ウェブと独自ソース(PubMed、arXiv、SEC 提出書類、特許など)の検索、URL からのコンテンツ抽出、根拠付きの回答、そして DeepResearch を扱えます。DeepResearch は非同期の調査エージェントで、出典付きのレポートと、必要に応じて PDF や CSV などのファイルを返します。

インストールは `npm install valyu-js` で、`VALYU_API_KEY` を渡して使います。現行版は 2.11.5 で、2026年10月31日に npm で公開されました。SDK は MIT ですが、SDK が行う呼び出しはすべて Valyu のクレジットで課金されます。

Valyu TypeScript SDK (valyu-js)は使う価値があるか?

valyu-js はよく手入れされたラッパーで、その価値は背後の Valyu API 次第で上下します。SDK 自体は MIT で無料ですが、キーがなければ何もできず、検索、抽出、調査タスクはすべてクレジットで課金されます。導入前に答えるべき問いは、クライアントの出来ではなく、自分のクエリで Valyu のデータが Exa、Tavily、自前のクローラーより優れているかどうかです。

クライアントの出来は良好です。changelog を読む限り、2.11.0 から 2.11.5 が短期間に続けて出ており、`instant` 調査モード、429 応答時の自動リトライ(既定で 2 回、Retry-After を最大 60 秒まで尊重)、DeepResearch リクエストの 120 秒タイムアウト、ETag によるポーリング、`contents()` のページ単位のキャッシュ制御が加わりました。修正のいくつかは、`countryCode` を誤った表記で送っていたなど、SDK が黙って捨てていたオプションに関するものでした。この率直さは安心材料であり、最新版を使い続ける理由でもあります。

DeepResearch はモードごとのタスク単位の料金です。instant は 8 クレジット、fast は 25、standard は 100、heavy は 500、max は 2,500 で、検索とページの読み込みは含まれます。従量課金の $10 で 1,600 クレジットという単価では、fast のタスクは約 $0.16、max は約 $15.60 です。TypeScript SDK の既定は fast ですが、API と Python SDK の既定は standard なので、同じ呼び出しでもクライアントが違えば 4 倍かかることがあります。成果物ファイルは最初の 1 つを超えると 1 つにつき 16 クレジットです。検索はソース別に結果 1,000 件あたりの料金で、arXiv と PubMed は約 $0.31、ウェブは $0.63、ライセンス済み学術誌は最大 $30 です。

注意点:採用の証拠は少なく、ほとんどが身内のものです。リポジトリの GitHub スターは 2 つで、npm のダウンロード数は 2026年11月2日までの 30 日間で 19,281 件でした。目に見えるオープンソースの利用例は、Global Threat Map、Global Hack Map、Polyseer など Valyu に近い人々のデモアプリです。これは API がそれらのアプリで動くことの証拠であって、市場シェアの証拠ではありません。また、キーは課金用の認証情報です。SDK はサーバー側のコード向けであり、`VALYU_API_KEY` を含むブラウザ向けバンドルは、開発者ツールを開いた誰にでもクレジット残高を渡すことになります。

結論:valyu-js は Valyu を試すための費用と考えればよく、その費用は小さいものです。Valyu そのものは、製品に組み込む前に自分のクエリのサンプルで評価するべきです。

真価を発揮する場面

  • Next.js でバイオテク文献アシスタントを作る 2 人のスタートアップ

    スクレイパーを保守せずに、サーバー側から PubMed と臨床試験を検索したい

    API ルートから `searchType: "proprietary"` と PubMed に絞った `includedSources` で `valyu.search()` を呼びます。結果は返された 1,000 件あたりで課金され、PubMed は約 $0.31 なので、試作品なら登録時の $10 のクレジットで回ります。

  • 小規模ファンドの株式アナリスト

    毎朝、ある企業について出典付きの第一稿がほしい

    `batch` を使って fast モードの `deepresearch.create()` ジョブを 1 件 25 クレジット(従量課金で約 $0.16)でキューに入れ、markdown か PDF の出力を読みます。heavy モードは 1 レポート 500 クレジットなので、モードの選択が請求額を決めます。

  • 社内エージェントにウェブ閲覧を加えるプラットフォームエンジニア

    URL の一覧をきれいなテキストや JSON の項目に変えたい

    `contents()` は同期で 1〜10 件、非同期で最大 50 件の URL を受け付け、構造化抽出用の JSON スキーマや、新しいクロールを強制する `maxAge` も指定できます。サーバー側だけで実行し、キーはシークレット管理に保管します。

導入前に確認すること

導入
`npm install valyu-js` を実行し、`VALYU_API_KEY` を設定して `new Valyu(process.env.VALYU_API_KEY)` を呼びます。最初の検索まで数分で、登録にカードは不要です。
連携
同じ API を Python SDK でも使えます。README には Vercel AI SDK(@valyu/ai-sdk)、LangChain、MCP との連携が挙げられています。すべてのリクエストとレスポンスの TypeScript 型がエクスポートされています。
データとプライバシー
クエリと URL は Valyu のホスト型 API に送られ、SDK にセルフホストのモードはありません。Valyu のデータ保持や学習利用の条件は SDK のドキュメントでは扱われていません。DeepResearch のダウンロードリンクは署名付きで、期限切れになります。
大規模利用時のコスト
月額プランは $29 で 5,000 クレジット、$99 で 18,000、$499 で 100,000 で、クレジットは繰り越されません。残高がゼロになると、超過分を請求する代わりに新しいリクエストは 402 を返します。ドキュメントによると DeepResearch の同時実行数はプラン次第で、従量課金では同時に 2 タスク、$29 のプランでは 5 タスクです。
制限
検索は 1 回の呼び出しで最大 20 件の結果を返します。DeepResearch の上限時間は 2 分(instant)から 90 分(max)までで、`wait()` は 2 時間で打ち切ります。リクエスト数のレート制限の数値は公開されていません。

良い点

  • search、contents、answer、DeepResearch、batch、workflows を 1 つの型付きクライアントで扱える
  • 429 時の安全な自動リトライ、サーバーの Retry-After を尊重
  • 頻繁なリリースと、詳しく率直な changelog
  • MIT ライセンス

気になる点

  • 有料の従量課金 Valyu アカウントがなければ使えない
  • TypeScript の既定モード(fast)が API の既定(standard)と異なる
  • Valyu に近いデモアプリ以外での独立した採用が乏しい
  • 最近の修正の複数が、以前はエラーなしで捨てられていたオプションに関するもの

おすすめの人

Valyu のデータソースが自分たちのエージェントに合うとすでに判断し、公式で保守されたクライアントを求める TypeScript チーム。

Valyu TypeScript SDK (valyu-js)の代替

Valyu TypeScript SDK (valyu-js):よくある質問

Valyu TypeScript SDK (valyu-js)は使う価値があるか?
有料 API 1 本のための丁寧で更新の速いクライアントです。コードは MIT ですが、実際に買っているのは Valyu のクレジットメーターです。 評価は5点満点中3.8点です。
Valyu TypeScript SDK (valyu-js)の料金は?
SDK は MIT で無料です。Valyu API はクレジット制の従量課金です。従量課金は $10 で 1,600 クレジット、月額プランは $29、$99、$499 です。新規アカウントには $10 分の無料クレジット(会社のメールアドレスなら $20)が付きます。
Valyu TypeScript SDK (valyu-js)の欠点は?
有料の従量課金 Valyu アカウントがなければ使えない; TypeScript の既定モード(fast)が API の既定(standard)と異なる; Valyu に近いデモアプリ以外での独立した採用が乏しい; 最近の修正の複数が、以前はエラーなしで捨てられていたオプションに関するもの.
Valyu TypeScript SDK (valyu-js)は誰に向いているか?
Valyu のデータソースが自分たちのエージェントに合うとすでに判断し、公式で保守されたクライアントを求める TypeScript チーム。
チームや本番環境でValyu TypeScript SDK (valyu-js)を使うと費用はいくらか?
月額プランは $29 で 5,000 クレジット、$99 で 18,000、$499 で 100,000 で、クレジットは繰り越されません。残高がゼロになると、超過分を請求する代わりに新しいリクエストは 402 を返します。ドキュメントによると DeepResearch の同時実行数はプラン次第で、従量課金では同時に 2 タスク、$29 のプランでは 5 タスクです。
Valyu TypeScript SDK (valyu-js)は企業データを扱っても安全か?
クエリと URL は Valyu のホスト型 API に送られ、SDK にセルフホストのモードはありません。Valyu のデータ保持や学習利用の条件は SDK のドキュメントでは扱われていません。DeepResearch のダウンロードリンクは署名付きで、期限切れになります。
Valyu TypeScript SDK (valyu-js)の代わりになるものは?
当サイトでレビューした中で最も近い代替はFirecrawl, Crawl4AI 、 GPT Researcherです。

回答確認日:2026年11月3日