検証環境：WordPress 6.9.4 / PHP 8.3.21 / Rapls AI Chatbot Free v1.5.6 / Cocoon 2.9.1.1 / Xserver スタンダードプラン（2026年4月時点）
WordPress 6.3 以上 ／ PHP 7.4 以上 ／ WordPress.org 公式ディレクトリに掲載
なぜこのプラグインを作ったか
「AIチャットボットをWordPressに入れたい」と思って既存プラグインを調べたところ、多くが特定のAIプロバイダーにロックインされていたり、Free版の機能制限が厳しかったり、サイト固有の情報に基づいた回答ができなかったりして、自分が欲しいものがなかったのが開発のきっかけです。
このプラグインを作り始めた動機は、自分のサイトに「サイトの情報をもとに答えてくれるAIチャットボット」を設置したかったことです。
既存のWordPress用AIチャットボットプラグインを調べてみると、いくつかの問題がありました。OpenAIにしか対応しておらず、他のプロバイダーに切り替えられない。Free版では月間のメッセージ数やナレッジベースの件数に上限がある。そして最大の問題は、多くのプラグインが「一般知識で回答するだけ」で、自分のサイトの情報を学習して回答する仕組み（RAG）を持っていなかったことです。
訪問者が「あなたのサービスの料金は？」と聞いても、サイトの情報を持っていないAIは答えられません。これでは設置する意味が薄い。そこで、RAGをコア機能として組み込んだプラグインを自分で作ることにしました。
このプラグインが解決する課題
問い合わせの自動応答、サイト内情報の即時検索、最新情報のWeb検索補完の3つが主要な課題解決で、RAG（Retrieval-Augmented Generation）によりサイト固有の情報を元に回答できるのが一般的なAIチャットとの違いです。
| 課題 | チャットボット導入後 |
|---|---|
| 問い合わせメールへの手動返信 | FAQをナレッジベースに登録 → AIが24時間自動回答 |
| サイト内の情報が見つからない | RAG検索でサイトコンテンツを参照して即答 |
| 最新情報への対応 | Web検索ツールで自動補完 |
訪問者の質問 → AIが一般知識で回答 → サイト固有の情報は答えられない【RAG搭載のRapls AI Chatbot】
訪問者の質問 → サイトコンテンツ・ナレッジベースを検索 → 関連情報をAIに渡す → サイトの内容を元に回答
どんなサイトで使えるか
ECサイトのFAQ自動応答、SaaS企業のドキュメント検索、ブログの記事案内、飲食店・クリニックの営業時間回答など、「訪問者が質問しそうな情報がサイト内にあるサイト」であれば業種を問わず活用できます。
ECサイト・ショッピング。「送料はいくらですか？」「返品できますか？」のような定型的な問い合わせにAIが24時間自動応答します。ナレッジベースにFAQを登録するだけで問い合わせメール数を削減できます。
SaaS・テック企業のドキュメントサイト。ドキュメントやAPIリファレンスをRAGで学習させると、技術的な質問にもドキュメントを引用しながら回答できます。
ブログ・メディアサイト。サイト学習で全記事をインデックスすれば、「○○について書いた記事はある？」という質問に関連記事を案内できます。インタラクティブな検索窓として機能します。
飲食店・クリニック・士業。営業時間・予約方法・料金体系をナレッジベースに登録するだけで「今日やっていますか？」のような質問に即答できます。電話問い合わせの削減効果が高いジャンルです。
主な機能と設計判断
4社AIプロバイダー対応（ロックインを避けるため）、ベクトルRAG（ハイブリッド検索で精度を確保）、Web検索（ナレッジ不足時の補完）、MCP Server（AIツール連携の将来性）の4つをコア機能として、Free版で機能制限をかけない方針で開発しました。
4社AIプロバイダー対応 ― ロックインを避ける
OpenAI、Anthropic Claude、Google Gemini、OpenRouterの4社に対応しています。管理画面のドロップダウンからプロバイダーとモデルを選択し、APIキーを入力するだけで切り替えられます。
4社対応にした理由は「特定のプロバイダーに依存したくなかった」からです。AIの世界はモデルの性能やコストが数ヶ月単位で変わります。OpenAIが最強の時期もあれば、Claudeが追い抜く時期もある。プロバイダーを自由に切り替えられることが、長期運用では重要だと考えました。
OpenRouterを追加したのは「1つのAPIキーで100以上のモデルを使える」という利便性が高いためです。コスト比較や性能テストがAPIキーの切り替えなしでできます。
ベクトルRAG ― ハイブリッド検索で精度を確保
サイトのコンテンツをチャンク分割してベクトル埋め込みを生成し、インデックスに保存します。訪問者が質問すると、キーワード検索（40%）とベクトル類似度検索（60%）のハイブリッドスコアリングで最も関連性の高いコンテンツを取得し、AIのプロンプトに含めます。
純粋なキーワード検索だけだと「送料について」と「配送料金」で検索結果が変わってしまいます。ベクトル検索を併用することで、言い回しが違っても意味的に近いコンテンツを見つけられるようにしました。比率を40:60にしたのは、テスト中にベクトルだけだと「なんとなく近い」結果が混ざりやすかったため、キーワードの完全一致も一定の重みを持たせたほうが精度が安定したからです。
Web検索 ― ナレッジ不足時の補完
ナレッジベースとサイト学習データで回答が不足する場合、AIがインターネットを検索して最新情報を取得します。各プロバイダーのネイティブ検索ツール（OpenAIのweb_search_preview、Claudeのweb_search、Geminiのgoogle_searchグラウンディング）を使用するため、追加のAPIキーは不要です。
MCP Server ― AIツールとの連携
JSON-RPC 2.0に準拠したMCP（Model Context Protocol）Serverを内蔵しており、Claude DesktopやCursorからサイトのデータに直接アクセスできます。サイト情報の取得、ナレッジベース検索、会話履歴の取得など7つのツールを提供しています。
その他の主な機能
Gutenbergブロックとショートコードの両方に対応、クロスサイトiframe埋め込み、ナレッジベース（Q&A・フリーテキスト・PDF/DOCX・CSVインポートの4形式）、サイト自動クロール（差分クロール対応）、会話履歴・使用量統計ダッシュボード、フィードバック・再生成機能、言語自動検出、reCAPTCHA v3対応、6種類のテーマを搭載しています。
Free版で制限をかけない理由
「Free版は月間100メッセージまで」のような制限をかけるのが業界の慣習ですが、AIチャットボットのコストはAPI使用料であってプラグイン側ではないため、人工的な制限をかけるのは筋が通らないと判断しました。Free版はAI応答数もナレッジベース件数も無制限です。
多くのAIチャットボットプラグインは、Free版に「月間○件まで」「ナレッジベース○件まで」という制限をかけています。これはビジネスモデルとして理解できますが、AIチャットボットの実際のコストはプラグイン側ではなくAI APIの使用料です。プラグインが制限をかけても、ユーザーが払うコストが減るわけではありません。
そこで、Free版では人工的な制限を一切かけない方針にしました。v1.5.1で既存の制限も撤廃し、AI応答数・ナレッジベース件数ともに無制限にしています。Pro版は「ビジネス成果につなげる機能」（リード獲得フォーム、会話シナリオ、WooCommerce連携、暗号化など）で差別化しています。
インストールと初期設定
WordPress管理画面から「Rapls AI Chatbot」で検索してインストールし、有効化後にAI設定タブからプロバイダーとAPIキーを入力するだけで使い始められます。初期設定は5分で完了します。
- WordPress管理画面の「プラグイン」→「新規プラグインを追加」を開く
- 検索欄に「Rapls AI Chatbot」と入力
- 「今すぐインストール」→「有効化」をクリック
- 「AI Chatbot」→「設定」→「AI 設定」タブから使用するプロバイダーとAPIキーを入力
- 「サイト学習」タブでクロールを実行し、サイトのコンテンツをインデックスに登録
APIキーの取得先は以下の通りです。
- OpenAI：platform.openai.com/api-keys
- Anthropic Claude：console.anthropic.com
- Google Gemini：aistudio.google.com（無料枠あり。低コスト運用に向いています）
- OpenRouter：openrouter.ai/keys
つまずきやすいポイントと対処法
開発中とサポートフォーラムで最も多く報告されたのが「チャットボットが表示されない」「AIが一般論しか返さない」「APIエラーが出る」の3パターンで、いずれも原因と対処法がほぼ決まっています。
チャットボットが表示されない
最も多い原因は、WordfenceやSiteGuardなどのセキュリティプラグインがREST APIをブロックしているケースです。プラグインの設定で/wp-json/wp-ai-chatbot/v1/をホワイトリストに追加してください。Xserverの場合は管理画面の「REST APIアクセス制限」が有効になっていないかも確認が必要です。
次に多いのがキャッシュプラグインとの競合です。プラグイン更新後はキャッシュをクリアしてください。
AIの回答が一般論しか返さない
サイト学習のインデックス済みページ数が0になっていることがほとんどです。「AI Chatbot」→「サイト学習」でクロールを実行してください。ナレッジベースに重要なQ&Aを登録するだけでも回答精度は大きく改善します。
APIエラーが出る
401 UnauthorizedはAPIキーの入力ミス（スペースの混入が多い）、429 Too Many Requestsはプロバイダー側のレート制限超過（しばらく待つと回復）、500 Internal Server Errorはサーバー側の問題（PHPエラーログを確認）です。
Pro版でできること
Free版の「設置して動かす」に加えて、リード獲得フォーム、会話シナリオ、WooCommerce連携、AES-256-GCM暗号化、高度なアナリティクスなど80以上の「ビジネス成果につなげる」機能を追加します。
リード獲得フォーム。チャット内にカスタムフィールド付きのフォームを表示し、名前・メール・会社名などを取得します。CSV/JSONエクスポート、Google Sheets連携、Webhook連携が可能です。
会話シナリオ。「資料請求」「価格確認」「サポート」など目的別の多段階フローを定義でき、条件分岐・メール送信・Webhook実行まで自動化できます。
WooCommerce連携。訪問者がチャットで商品について質問すると、価格・在庫・商品画像・購入リンクを含んだカードをチャット内に自動表示します。
セキュリティ強化。AES-256-GCM暗号化（APIキー・メッセージ・リードデータ）、PII自動マスク、監査ログ、設定変更履歴とロールバックなど、企業サイト向けの管理機能を搭載しています。
Pro版の全機能の詳細はPro版マニュアルを参照してください。
マニュアル
設定項目の詳細、フィルターフック、REST APIエンドポイントなどの技術情報は、Free版・Pro版それぞれの日本語・英語マニュアルにまとめています。
| マニュアル | 内容 |
|---|---|
| Free版マニュアル（日本語） | 全設定項目・フィルターフック・REST API・セキュリティ設定など |
| Pro版マニュアル（日本語） | 80以上のPro版機能の設定・活用方法 |
| Free Manual (English) | Full settings, filter hooks, REST API, security |
| Pro Manual (English) | 80+ Pro features documentation |
まとめ
Rapls AI Chatbotは「サイトの情報を元にAIが回答する」をFree版で完全に実現するWordPressプラグインです。4社AI対応・RAGハイブリッド検索・Web検索・MCP Serverをすべて無料で提供し、プロバイダーロックインなしで運用できます。
このプラグインを作った動機は「自分が欲しいものがなかった」というシンプルな理由です。特定プロバイダーへのロックインなし、Free版の人工的な制限なし、サイト固有の情報に基づいた回答ができる。この3つを満たすプラグインを目指して開発しました。
バグ報告や機能リクエストはWordPress.orgのサポートフォーラムからお願いします。
コメント