> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Helius for Agents

> AIエージェントがHeliusでSolana上に構築するために必要なすべて: プログラムによるサインアップ、APIアクセス、SDK、MCP統合、おすすめのワークフロー。

Heliusは、Solana上に構築するAIエージェントを最高のサポートで提供します。プログラムによるアカウント作成からリアルタイムデータストリーミングまで、エージェントは手動での操作なしでHeliusのすべての機能にアクセスできます。

* [Helius MCP](/ja/agents/mcp) — ブロックチェーンのクエリ、トランザクション送信、ストリーミングなどをカバーする10のルーテッドツール
* [Claude Code Plugin](/ja/agents/claude-code-plugin) — 暗号会社からの最初で現在唯一の公式Claude Codeプラグイン。1回のインストールで: MCPサーバー+スキル+参照ファイル
* [Skills](/ja/agents/skills/overview) — Claude向けの専門指導セット: [Build](/ja/agents/skills/build), [Phantom](/ja/agents/skills/phantom), [Jupiter](/ja/agents/skills/jupiter), [DFlow](/ja/agents/skills/dflow), [OKX](/ja/agents/skills/okx), [SVM](/ja/agents/skills/svm)
* [TypeScript SDK](/ja/agents/typescript-sdk) — すべてのHelius API向けの型安全なメソッド
* [Rust SDK](/ja/agents/rust-sdk) — Helius API向けの高性能Rust SDK
* [Helius CLI](/ja/agents/cli) — アカウント管理とシェルスクリプト

<Note>
  このセクションの機械可読バージョンはAIエージェント用に[agents/llms.txt](https://www.helius.dev/docs/agents/llms.txt)で利用可能です。
</Note>

## MCP対CLI

[Helius MCPサーバー](/ja/agents/mcp)は、AIエージェントがHeliusと対話するための推奨方法です。これにより、AIはSolanaに直接的で体系的なアクセスが可能になります。シェルコマンドや出力解析、手動のAPI呼び出しは不要です。

|              | [MCP](/ja/agents/mcp)                                                            | [CLI](/ja/agents/cli)                   |
| ------------ | -------------------------------------------------------------------------------- | --------------------------------------- |
| **最適な用途**    | Claude Code、Cursor、Claude Desktop、MCP互換ツールでのAIエージェント                             | シェルスクリプト、CI/CDパイプライン、ターミナルワークフロー        |
| **インターフェース** | 型付き入出力を持つ構造化されたツール呼び出し                                                           | `--json` 出力を持つコマンドライン                   |
| **機能**       | ブロックチェーンクエリ、トランザクション、ウェブフック、ストリーミング、ウォレット解析、ドキュメント、サインアップをカバーする10のルーテッドツール       | 95以上のコマンド: 同じ機能に加えて、設定管理とインタラクティブフローを含む |
| **アカウント設定**  | 組み込み: `heliusAccount` アクション `generateKeypair` → `signup` （リンクまたは自動支払い）— 外部ツールは不要 | `helius keygen` → `helius signup`       |
| **使用タイミング**  | すべてのAIエージェントのデフォルトの選択肢                                                           | シェルレベルの自動化が必要な場合、またはMCP互換ツールを使用しない場合    |

<Tip>
  **MCPから始めましょう。** AIツールがMCP（Claude Code、Cursor、Claude Desktopなど）をサポートしている場合は、[MCPサーバー](/ja/agents/mcp)または[Claude Code Plugin](/ja/agents/claude-code-plugin)を使用してください。CLIはシェルスクリプティングやCI/CDに役立ちますが、AI駆動のワークフローにはMCPの方がシームレスな体験を提供します。AIはシェルコマンドを生成して出力を解析するのではなく、ツールを直接呼び出します。
</Tip>

## クイックスタート: エージェントサインアップ

エージェントは[Helius CLI](/ja/agents/cli)を使用して、4ステップでHeliusアカウントを作成しAPIキーを取得できます。

```bash theme={"system"}
npm install -g helius-cli    # Install CLI
helius keygen                 # Generate keypair
# (Autopay only) Fund wallet with 1 USDC + ~0.001 SOL — skip if paying via the hosted link
helius signup --email you@example.com --first-name Jane --last-name Doe --json          # Get API key (JSON output)
```

成功すると、エージェントはAPIキー、RPCエンドポイント、1,000,000クレジットを受け取ります。詳細は[完全なCLIガイド](/ja/agents/cli)を参照してください。

## 認証

すべてのHelius APIリクエストには、クエリパラメータとして渡されるAPIキーが必要です。

```
?api-key=YOUR_API_KEY
```

これを任意のRPCまたはAPIエンドポイントに追加します。例: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`

APIキーは[Heliusダッシュボード](https://dashboard.helius.dev)または[Helius CLI](/ja/agents/cli)を介してプログラム的に取得できます。

<Tip>
  **Gatekeeperを使用してレイテンシを下げる** — [Gatekeeper（ベータ）](/ja/gatekeeper/overview)はクラウドフレアをクリティカルパスから外し、応答時間を数十から数百ミリ秒短縮します。同じAPIキー、同じメソッド — 単にエンドポイントを切り替えます。

  ```
  https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  ```

  すべてのRPC、DAS、WebSocket、ZK Compression、Priority Fee、Enhanced Transactionメソッドをサポートします。詳細は[移行ガイド](/ja/gatekeeper/migration-guide)を参照してください。
</Tip>

## Helius固有のAPIガイダンス

通常のSolana RPCメソッドを連鎖する代わりに、これらのHelius最適化APIを使用してください。

| 代わりに...                                      | これを利用                                                                                                                 | 理由                                                   |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `getSignaturesForAddress` + `getTransaction` | [`getTransactionsForAddress`](/ja/rpc/gettransactionsforaddress)                                                      | トークンアカウントデータを含む完全な取引履歴を単一呼び出しで取得                     |
| `getTokenAccountsByOwner`                    | [`getAssetsByOwner`](/ja/api-reference/das/getassetsbyowner) (DAS API)                                                | 生のアカウントでなく、豊富なメタデータを返す                               |
| `getRecentPrioritizationFees`                | [`getPriorityFeeEstimate`](/ja/api-reference/priority-fee/getpriorityfeeestimate)                                     | 手動計算のない、事前計算された最適な料金                                 |
| `getSignaturesForAddress` (cNFT用)            | [`getSignaturesForAsset`](/ja/api-reference/das/getsignaturesforasset) (DAS API)                                      | 標準RPCは圧縮NFTには対応していません                                |
| `getProgramAccounts` (NFT検索用)                | [`searchAssets`](/ja/api-reference/das/searchassets) または [`getAssetsByGroup`](/ja/api-reference/das/getassetsbygroup) | より速く安価な、インデックス化されたデータ                                |
| リアルタイムデータのポーリング                              | [LaserStream WebSocket](/ja/rpc/websocket) または [LaserStream gRPC](/ja/laserstream)                                    | 低レイテンシでより効率的                                         |
| 標準`sendTransaction`                          | [Helius Sender](/ja/sending-transactions/sender)                                                                      | マルチパスルーティング（Helius, Jito, Harmonic, Rakuraiなど）、高い着地率 |

## 推奨ワークフロー

| 構築するもの...    | 使用するHelius製品                                                                                                                                                                                |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| トレーディングボット   | [Gatekeeper](/ja/gatekeeper/overview)（最低レイテンシのRPC）+ [Sender](/ja/sending-transactions/sender)（迅速な取引送信）+ [Priority Fee API](/ja/priority-fee-api) + [LaserStream](/ja/laserstream)（リアルタイム価格） |
| ウォレットアプリ     | [DAS API](/ja/das-api) (`getAssetsByOwner`) + [`getTransactionsForAddress`](/ja/rpc/gettransactionsforaddress)（完全履歴）                                                                        |
| NFTマーケットプレイス | [DAS API](/ja/das-api) (`searchAssets`, `getAssetsByGroup`) + [Webhooks](/ja/webhooks)（販売/リスティングの追跡）                                                                                        |
| トークンスナイパー    | [Gatekeeper](/ja/gatekeeper/overview)（エッジルーティングRPC）+ [LaserStream gRPC](/ja/laserstream)（最低レイテンシ）+ [Sender](/ja/sending-transactions/sender)（ステークされた接続）                                     |
| ポートフォリオトラッカー | [DAS API](/ja/das-api) (`getAssetsByOwner` with `showFungible`) + [Enhanced Transactions](/ja/enhanced-transactions/overview)                                                               |
| ウォレットモニター    | [LaserStream WebSocket](/ja/rpc/websocket) または [Webhooks](/ja/webhooks) を使用したリアルタイム通知                                                                                                       |
| 分析ダッシュボード    | [Enhanced Transactions API](/ja/enhanced-transactions/overview) + [`getTransactionsForAddress`](/ja/rpc/gettransactionsforaddress)                                                          |
| エアドロップツール    | [AirShip](https://airship.helius.dev)（ZK圧縮で95%安価）                                                                                                                                           |

## レート制限クイックリファレンス

レート制限は[プラン](/ja/billing/plans)に依存します。エージェントは1,000,000クレジットのエージェント層からスタートします。エージェント層は濫用防止のために\$1の支払いが必要です。

| プラン       | 価格        | 月間クレジット | RPCレート制限  | DAS & Enhanced APIs |
| --------- | --------- | ------- | --------- | ------------------- |
| エージェント    | \$1サインアップ | 1M      | 10 req/s  | 2 req/s             |
| 開発者       | \$49/月    | 10M     | 50 req/s  | 10 req/s            |
| ビジネス      | \$499/月   | 100M    | 200 req/s | 50 req/s            |
| プロフェッショナル | \$999/月   | 200M    | 500 req/s | 100 req/s           |

詳細なAPIごとのレート制限は[レート制限](/ja/billing/rate-limits)を参照してください。

## API呼び出しごとのクレジット

| API                         | クレジット | 備考                                                   |
| --------------------------- | ----- | ---------------------------------------------------- |
| 標準RPC呼び出し                   | 1     | ほとんどのSolana RPCメソッド                                  |
| `getProgramAccounts`        | 10    | 可能な限りDAS APIを使用                                      |
| DAS API                     | 10    | すべてのDASエンドポイント                                       |
| Enhanced Transactions       | 100   | 解析済みトランザクションデータ                                      |
| `getTransactionsForAddress` | 10+   | 完全なトランザクションは返される100ごとに10クレジット; シグネチャのみの応答は10クレジット固定。 |
| `getTransfersByAddress`     | 10    | 開発者以上のプランのみ                                          |
| ウォレットAPI                    | 100   | すべてのウォレットAPIエンドポイント                                  |
| Priority Fee API            | 1     | 料金推定                                                 |
| Sender                      | 0     | すべてのプランで無料                                           |
| ウェブフックイベント                  | 1     | 配信されたイベントごと                                          |
| ウェブフック管理                    | 100   | 作成、編集、削除                                             |

詳細は[クレジット](/ja/billing/credits)を参照してください。

## リトライとエラーハンドリング

### HTTPステータスコード

| コード | 意味      | アクション         |
| --- | ------- | ------------- |
| 200 | 成功      | 応答を処理         |
| 400 | 不正リクエスト | リクエストパラメータを修正 |
| 401 | 未認証     | APIキーを確認      |
| 429 | レート制限   | バックオフして再試行    |
| 5xx | サーバーエラー | 指数バックオフで再試行   |

### リトライパターン

```typescript theme={"system"}
async function heliusRequest(url: string, data: object, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(data),
    });

    if (response.ok) return response.json();

    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After');
      const delay = retryAfter ? parseInt(retryAfter) * 1000 : Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    if (response.status >= 500) {
      await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
      continue;
    }

    throw new Error(`Request failed: ${response.status} ${await response.text()}`);
  }
  throw new Error('Max retries exceeded');
}
```

### クレジット使用量を監視

```bash theme={"system"}
helius usage --json
```

## クイックリファレンス

* **メインネットRPC**: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **メインネットRPC（Gatekeeperベータ）**: `https://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **デブネットRPC**: `https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **メインネットWSS**: `wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **メインネットWSS（Gatekeeperベータ）**: `wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY`
* **デブネットWSS**: `wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* **Senderエンドポイント**: `https://sender.helius-rpc.com/fast`
* **MCPサーバー**: `https://www.helius.dev/docs/mcp`
* **ダッシュボード**: [dashboard.helius.dev](https://dashboard.helius.dev)
* **ステータス**: [helius.statuspage.io](https://helius.statuspage.io)