use-sapiom

Sapiom

1 つの MCP サーバーで 97 種類のクラウドサービスツールを利用できます。スクレイピング、計算、保存、検索、生成を従量課金で利用でき、ベンダーアカウントは不要です。

クイックセットアップ — MCP サーバー（推奨）

# Claude Code CLI
claude mcp add sapiom --transport http https://api.sapiom.ai/v1/mcp

{
  "mcpServers": {
    "sapiom": {
      "type": "http",
      "url": "https://api.sapiom.ai/v1/mcp"
    }
  }
}

ブラウザー認証が自動的に使用されます。代わりに API キーを使用するには、--header "Authorization:Bearer YOUR_KEY" を追加するか、headers フィールドを設定してください。キーは https://app.sapiom.ai/settings で取得できます。

使用する場面

• Web コンテンツの スクレイピングと抽出、サイトのクロール、スクリーンショットの撮影
• ファイルの入出力とプロセス管理に対応したクラウドサンドボックスで コードを実行（Node、Python、Go、Rust）
• Redis、Vector DB、Search Index、または一時的な Postgres に データを保存
• Linkup（高速）または You.com（詳細）で Web を検索
• メディアを生成 — 画像（Fal.ai）、音声（ElevenLabs）、効果音
• キュー、スケジュール、パブ／サブ経由で メッセージを送信

エージェントを構築していますか？ sapiom-agent-builder をご利用ください。コードをデプロイするだけですか？ sapiom-deploy をご利用ください。

利用可能なツール

はじめに（2）

ツール	説明
sapiom_status	MCP セッションの認証とテナントのコンテキストを確認します
tool_discover	キーワードで適切なツールを探します（無料）

スクレイピングとブラウザー（9） — 詳細

ツール	説明
sapiom_fetch	URL からメインコンテンツをクリーンな Markdown として取得します
sapiom_screenshot	Web ページのスクリーンショットを撮影します（PNG URL）
sapiom_scrape	形式オプションとセレクターを指定して高度なスクレイピングを行います
sapiom_crawl	Web サイト全体をクロールします（非同期、ジョブ ID を返します）
sapiom_crawl_status	クロールジョブのステータスを確認し、結果を取得します
sapiom_map	サイト上のすべての URL を検出します（高速サイトマップ）
sapiom_extract	プロンプトとスキーマを使って構造化データを抽出します
sapiom_extract_status	抽出ジョブのステータスを確認し、結果を取得します
sapiom_site_search	特定の Web サイトのコンテンツ内を検索します

計算（31） — 詳細

ツール	説明
sapiom_run	クラウドでコードスニペットを実行します（Node/Python/Go/Rust）
sapiom_run_list	最近のコード実行を一覧表示します
sapiom_run_get	ID で実行結果を取得します
sapiom_sandbox_create	永続的なクラウドサンドボックスを作成します
sapiom_sandbox_list	アクティブなサンドボックスを一覧表示します
sapiom_sandbox_get	サンドボックスの詳細を取得します
sapiom_sandbox_delete	サンドボックスを削除します
sapiom_sandbox_extend	サンドボックスの有効期間を延長します
sapiom_sandbox_exec	サンドボックス内でコマンドを実行します
sapiom_sandbox_deploy	サンドボックスを永続サービスとしてデプロイします
sapiom_sandbox_write_file	サンドボックスにファイルを書き込みます
sapiom_sandbox_read_file	サンドボックスからファイルを読み取ります
sapiom_sandbox_list_files	サンドボックスのディレクトリ内のファイルを一覧表示します
sapiom_sandbox_delete_file	サンドボックスからファイルを削除します
sapiom_sandbox_process_logs	プロセスの stdout/stderr ログを取得します
sapiom_sandbox_process_list	サンドボックス内で実行中のプロセスを一覧表示します
sapiom_sandbox_process_get	PID でプロセスの詳細を取得します
sapiom_sandbox_process_stop	プロセスを正常に停止します
sapiom_sandbox_process_kill	プロセスを強制終了します
sapiom_sandbox_preview_create	ポートの公開プレビュー URL を作成します
sapiom_sandbox_preview_list	アクティブなプレビュー URL を一覧表示します
sapiom_sandbox_preview_delete	プレビュー URL を削除します
sapiom_sandbox_ports	サンドボックス内の開いているポートを一覧表示します
sapiom_job_deploy	スケジュールまたはトリガーで実行するジョブをデプロイします
sapiom_job_list	デプロイ済みのジョブを一覧表示します
sapiom_job_get	ジョブの詳細を取得します
sapiom_job_update	ジョブの設定を更新します
sapiom_job_delete	ジョブを削除します
sapiom_job_trigger	ジョブの実行を手動でトリガーします
sapiom_job_list_executions	ジョブの実行履歴を一覧表示します
sapiom_job_get_execution	ID で実行結果を取得します

データ（23） — 詳細

ツール	説明
sapiom_redis_create	サーバーレス Redis データベースを作成します
sapiom_redis_create_fixed	固定サイズの Redis データベースを作成します
sapiom_redis_list	Redis データベースの一覧を表示します
sapiom_redis_delete	Redis データベースを削除します
sapiom_redis_update	Redis データベースの名前を変更します
sapiom_redis_command	任意の Redis コマンドを実行します
sapiom_vector_create	ベクトルインデックスを作成します
sapiom_vector_list	ベクトルインデックスの一覧を表示します
sapiom_vector_delete	ベクトルインデックスを削除します
sapiom_vector_update	ベクトルインデックスの設定を更新します
sapiom_vector_upsert	メタデータ付きのベクトルをアップサートします
sapiom_vector_query	類似度でベクトルを検索します
sapiom_searchindex_create	全文検索インデックスを作成します
sapiom_searchindex_list	検索インデックスの一覧を表示します
sapiom_searchindex_delete	検索インデックスを削除します
sapiom_searchindex_update	検索インデックスのスキーマを更新します
sapiom_searchindex_upsert	検索インデックスにドキュメントをアップサートします
sapiom_searchindex_query	検索インデックスを検索します
sapiom_database_create	一時的な Neon Postgres データベースをプロビジョニングします
sapiom_database_price	Postgres の料金見積もりを取得します（無料）
sapiom_database_list	アクティブな Postgres データベースの一覧を表示します
sapiom_database_get	Postgres データベースの詳細と接続 URI を取得します
sapiom_database_delete	Postgres データベースを削除します

メッセージング（16） — 詳細

ツール	説明
sapiom_message_publish	URL エンドポイントにメッセージを送信します
sapiom_message_enqueue	名前付きキューにメッセージを登録します
sapiom_message_batch	1 回の呼び出しで複数のメッセージを送信します
sapiom_message_get	メッセージの配信状況を取得します
sapiom_message_cancel	保留中のメッセージをキャンセルします
sapiom_schedule_create	定期スケジュール（cron）を作成します
sapiom_schedule_list	スケジュールの一覧を表示します
sapiom_schedule_get	スケジュールの詳細を取得します
sapiom_schedule_delete	スケジュールを削除します
sapiom_schedule_pause	スケジュールを一時停止します
sapiom_schedule_resume	一時停止中のスケジュールを再開します
sapiom_queue_list	メッセージキューの一覧を表示します
sapiom_queue_get	キューの詳細を取得します
sapiom_queue_delete	キューを削除します
sapiom_queue_pause	キューを一時停止します
sapiom_queue_resume	一時停止中のキューを再開します

検索（2） — 詳細

ツール	説明
sapiom_search	Linkup 経由のウェブ検索 — 出典付きの AI 生成回答
sapiom_deep_search	You.com 経由のウェブ検索 — 整形されたウェブおよびニュースの検索結果

AI モデル（2） — 詳細

ツール	説明
sapiom_chat	OpenRouter 経由で任意の LLM にプロンプトを送信します
sapiom_list_models	利用可能な LLM モデルと料金の一覧を表示します

オーディオ（3） — 詳細

ツール	説明
sapiom_text_to_speech	テキストを音声に変換します（ElevenLabs）
sapiom_sound_effects	説明から効果音を生成します
sapiom_list_voices	利用可能な ElevenLabs 音声の一覧を表示します（無料）

画像（1） — 詳細

ツール	説明
sapiom_generate_image	テキストプロンプトから画像を生成します（Fal.ai FLUX）

検証（2） — 詳細

ツール	説明
sapiom_verify_send	SMS で認証コードを送信します
sapiom_verify_check	6 桁の認証コードを確認します

ガバナンス（6）— 詳細

ツール	説明
sapiom_create_agent	追跡用の名前付きエージェントを登録します
sapiom_list_agents	登録済みのエージェントを一覧表示します
sapiom_create_spending_rule	支出／利用上限を作成します
sapiom_list_spending_rules	支出ルールを一覧表示します
sapiom_create_transaction_api_key	新しい API キーを作成します
sapiom_authenticate	認証フローの手順を取得します

レシピ

1. トピックを調査する

sapiom_search（簡単な回答）→ sapiom_deep_search（より多くの結果）→ sapiom_fetch（記事全文を読む）→ sapiom_chat（調査結果を要約する）

2. ページの変更を監視する

sapiom_scrape（コンテンツを取得）→ sapiom_redis_command（ハッシュを保存し、前回の内容と比較）→ sapiom_message_publish（変更を通知）→ sapiom_schedule_create（毎時実行）

3. ナレッジベースを構築する

sapiom_crawl（ドキュメントサイトをクロール）→ sapiom_crawl_status（ページを取得）→ sapiom_vector_upsert（埋め込みを保存）→ sapiom_vector_query（セマンティック検索）

4. コードを実行してデプロイする

sapiom_run（コードスニペットをテスト）→ sapiom_sandbox_create（永続的な環境）→ sapiom_sandbox_exec（反復実行）→ sapiom_job_deploy（本番環境向けにスケジュール）

5. メディアを生成する

sapiom_generate_image（ビジュアルを作成） + sapiom_text_to_speech（ナレーション） + sapiom_sound_effects（背景音声）

ヒント

• tool_discover はキーワードから適切なツールを見つけます。無料なので、迷ったときに利用してください
• ゲートウェイへの呼び出しに agentName を渡すと、エージェントごとの支出を追跡できます
• sapiom_search（Linkup）＝高速な AI の回答、sapiom_deep_search（You.com）＝より多くの生の検索結果
• 使用前にリソースを準備してください：sapiom_redis_create、sapiom_vector_create、sapiom_database_create
• 自律型エージェントをデプロイする前に、sapiom_create_spending_rule で支出ルールを設定してください
• sapiom_database_price は無料です。Postgres DB を作成する前に、必ずコストを確認してください

SDK アクセス（直接 HTTP）

MCP を介さずに HTTP を直接呼び出すには、SDK を使用してください：

npm install @sapiom/fetch
# or: npm install @sapiom/axios axios

const { createFetch } = require("@sapiom/fetch");
const safeFetch = createFetch({ apiKey: process.env.SAPIOM_API_KEY });

const res = await safeFetch("https://linkup.services.sapiom.ai/v1/search", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ q: "quantum computing", depth: "standard", outputType: "sourcedAnswer" }),
});

Python／curl：X-402-Payment ヘッダーを使用した標準の HTTP を利用してください。ゲートウェイ URL はリファレンスファイルを参照してください。

トラブルシューティング

問題	原因	解決方法
402 Payment Required	残高不足、または支出ルールに抵触しています	app.sapiom.ai で残高を追加するか、sapiom_list_spending_rules を確認してください
MCP 接続が拒否される	URL が間違っているか、認証に問題があります	URL が https://api.sapiom.ai/v1/mcp であることを確認してください。ブラウザー認証を試すか、API キーを確認してください
tool_discover が何も返さない	クエリが曖昧すぎます	「scrape」、「redis」、「image」、「search」などの具体的なキーワードを使用してください
スクレイプ結果が空	JavaScript でレンダリングされるページには待機時間が必要です	sapiom_fetch ではなく、waitFor: 3000 を指定して sapiom_scrape を使用してください
「Resource not found」	リソースを準備する前にデータツールを使用しています	先に sapiom_redis_create、sapiom_vector_create などで作成してください
データベース URI がない	DB の準備がまだ完了していません	数秒待ってから、sapiom_database_get で状態を確認してください

リファレンス

ファイル	分野	ツール
scraping.md	Firecrawl + Anchor Browser	9
compute.md	サンドボックス、ジョブ、実行	31
data.md	Redis、Vector、Search、Postgres	23
messaging.md	QStash メッセージ、スケジュール、キュー	16
search.md	Linkup + You.com	2
ai-models.md	OpenRouter チャット + モデル	2
audio.md	ElevenLabs TTS + SFX	3
images.md	Fal.ai 画像生成	1
verify.md	Prelude 電話番号認証	2
governance.md	エージェント、ルール、API キー	6

ドキュメント全文：https://docs.sapiom.ai（生の Markdown を表示するには、任意の URL の末尾に .md を追加してください）