search

Aimnis

エージェントのための共同検索

一度検索すれば、みんなが回答を得られます。 コーディングエージェント向けの、オープンソースでキャッシュ優先のウェブ検索ゲートウェイです。質問するだけで、共有され、常に最新のナレッジプールから、出典を明記した要約回答をすぐに取得できます。検索のたびに、プールはより賢く、誰にとっても低コストになります。RAGのような仕組みですが、古くなった個人用ドキュメントではなく、みんなで使う最新のウェブ情報プールを対象にしています。

ステータス：パブリックプレビュー。 ホステッドサービスは稼働中です。無料の評価用キーを aimnis.com で取得し、1分でエージェントの接続を設定できます （エージェントごとのセットアップ）。私たちは、プールの成長に伴ってキャッシュヒット率が高まることを公開の場で実証しています （フライホイール、ライブダッシュボード）。ぜひご注目ください。

理由

すべてのモデルには学習データのカットオフがあります。モデルがリリースされた瞬間から、世界は先へ進みます。ライブラリの新バージョン、新しいAPI、新たなエラーが登場し、モデルは質問のたびに最新のウェブを検索しなければ追いつけません。それには時間もコストもかかり、ベンダーごとに個別対応が必要です。

Aimnisは、その手前にある共有の、常に最新のレイヤーです。エージェントが最初に確認する場所です。質問すると、過去に同じ質問（または意味的に類似した質問）がされていれば、出典を明記した要約回答をほぼゼロのコストですぐに取得できます。まだ質問されていなければ、Aimnisが最新情報を取得して要約し、プールに追加します。これにより、次に質問するエージェントは無料で回答を得られます。このコーパスには、すべてのモデルのカットオフ以降に起きたことが記録されており、静的な学習データセットでは実現できません。

仕組み

query
  └─ scrub secrets/PII (redacted before embed, search, distill, or storage)
       └─ local embed + normalize
            └─ semantic cache lookup (exact hash → vector nearest-neighbour)
                 ├─ HIT  → return the pooled, cited answer instantly (no upstream cost)
                 └─ MISS → live search → distill into a cited answer → quality-gate → pool it

• キャッシュ優先。 ナレッジプールそのものがセマンティックキャッシュ（pgvector）です。言い換えられた質問でも同じエントリーにヒットするため、プールは完全一致の場合より速く蓄積されます。
• 根拠に基づく、引用付きの回答。 キャッシュミス時は、最新のウェブ検索結果を要約し、ソースに対応する[n]の引用を付けた短い回答を生成します。生のリンクを返すわけではありません。回答はAI 生成（モデルがソースを要約）であり、ツールの出力にもその旨が示されるため、エージェントは機械生成の要約を読んでいることを常に把握できます。
• 出典と鮮度を標準で提示。 すべての回答には、使用したモデルとソース、キャッシュのタイムスタンプ（回答が生成または再要約された時刻であり、最後に提供された時刻ではありません）、および相対的な経過時間が含まれます。これにより、エージェント（および独自のランキング機能）は情報の古さを評価し、ライブ検索に切り替えるタイミングを判断できます。
• 引用リンクを関連性シグナルとして記録できます（オプトイン、集計のみ）。 有効にすると、引用されたソースへのリンクは署名付きの/r/…リダイレクトを経由します。このリダイレクトは、どのプール済み回答がその後のクリックにつながったかを記録してからソースへ転送します。これにより、クリック率に基づいてランキングを改善できます。エージェントが遷移先を把握できるよう、ソースの実際のホスト名はリンク内に表示されます。ログに記録されるのはエントリー + ソース + ホスト名 + 時刻のみで、IP、ユーザーエージェント、ユーザー／セッション ID は一切記録されません。これはプールに関するテレメトリーであり、利用者を追跡するものではありません。署名シークレットが設定されていない限り無効であり、トークンは HMAC 署名されるため、/rがオープンリダイレクターとして悪用されることはありません。また、セルフホストの場合、リダイレクト先はご自身のゲートウェイとなるため、クリックはご自身の環境内にとどまります。
• プライバシーに配慮した入力処理。 よくあるシークレット形式（API キー、トークン、秘密鍵、接続文字列）とメールアドレスは、クエリの埋め込み、検索／LLM プロバイダーへの送信、またはプールへの保存より前にマスキングされます。シークレットを多く含むクエリはライブ検索のみで処理され、保存されません。高精度な形式ベースの検出にエントロピー検査を組み合わせていますが、検出できるのは既知の形式であり、あらゆるシークレットや個人情報を検出できるわけではありません。そのため、保証ではなく多層防御の一環としてご利用ください。このパイプラインは、監査や拡張ができるよう、意図的にオープンソースにしています。実行場所について： セルフホストの場合、マスキングはローカルで行われるため、生のテキストが端末の外に出ることはありません。ホスト型ゲートウェイを利用する場合、クエリは TLS 経由で送信され、入力時に（メモリー内で、プロバイダーへの呼び出しや永続化より前に）マスキングされます。クエリが端末を離れる前にマスキングする必要がある場合は、セルフホストするか、ローカルモードでローカル MCP サーバーを実行してください。
• 品質審査済みのプール。 要約された回答は、プールに追加される前に品質審査を通過する必要があります。品質に問題がある場合は、生のスニペットに戻されるため、共有プールの品質を損なうことはありません。

フライホイール

成否を決める指標はひとつです。コーパスの規模に対するキャッシュヒット率です。プールの成長に伴ってヒット率も上がれば、この仮説は正しいといえます。この指標は初日から公開されます。信頼を測定可能な形にします。

# run the live dashboard locally (see Quickstart)
aimnis-dashboard      # → http://127.0.0.1:8080   (hit-rate curve, corpus size, storage)

コーディングエージェントで使う

Aimnis はMCPに対応しているため、MCP 対応のエージェントであればウェブ検索ツールとして利用できます。ホスト型エンドポイントを使えば、インストールは不要です。

1. **aimnis.com/register**で無料の評価用キーを取得します（メールで送付。使用量に応じた課金、取り消し可能、利用規約）。
2. リモート MCP サーバーをエージェントに追加します。

URL:     https://aimnis.com/mcp          (MCP, streamable HTTP)
Header:  Authorization: Bearer aim_YOUR_KEY

Claude Code

claude mcp add --transport http aimnis https://aimnis.com/mcp \
    --header "Authorization: Bearer aim_YOUR_KEY"

モデルが組み込みツールより Aimnis を優先して使うようにするには、.claude/settings.jsonでWebSearchを拒否します。

{ "permissions": { "deny": ["WebSearch"] } }

OpenCode、OpenClaw、Hermes、Pi、REST — コピー＆ペーストできる設定例はaimnis.com/setupとdocs/mcp.mdにあります。また、search／statsツールのリファレンスも参照できます。登録時にご自身の OpenRouter／検索キーを登録すると、キャッシュミスはご自身の利用枠で処理され、上限も大幅に高くなります。

セルフホストをご希望ですか？ 同じ MCP サーバーを、ご自身のプールに対して stdio 経由でローカル実行できます。クイックスタートとdocs/mcp.mdをご覧ください。

クイックスタート（開発）

cd server
docker compose up -d                    # Postgres+pgvector (:5432)
# want the keyless search path too? add SearXNG (:8888):
#   docker compose --profile keyless up -d
uv venv .venv && . .venv/bin/activate
uv pip install -e ".[dev]"              # editable install (required — see docs)
python -m aimnis.migrate                # apply migrations/*.sql
cp .env.example .env                    # then fill in keys if you have them
pytest                                  # full suite against the compose DB

OpenRouter のキーがなくても問題ありません。Aimnis はキーなし（SearXNG 経由）で動作し、引用付きの生スニペットを返すため、上流のクォータを一切消費しません。蒸留を有効にするには、AIMNIS_OPENROUTER_API_KEY を追加してください。ライブ検索は順序付きのフォールバックチェーン（Brave → Tavily → Exa → SearXNG）で行われるため、AIMNIS_BRAVE_API_KEY、AIMNIS_TAVILY_API_KEY、AIMNIS_EXA_API_KEY のいずれかを設定すると、より信頼性の高い結果が得られます。また、無料枠を使い切ると、自動的に次のサービスへ切り替わります。コンポーネントの構成については、server/README.md をご覧ください。

ライセンス

コードはオープンです。コーパスはキュレーションされた編集物であり、その編集物としてライセンスされています。

部分	ライセンス
サーバーコア（server/）	AGPLv3 — ネットワークコピーレフトです。変更したサービスを実行する場合、変更内容を共有してください
SDK と MCP クライアント（clients/）	Apache-2.0 — 商用製品を含め、あらゆる場所に組み込めます
公開ナレッジプールのページ	CC-BY-NC 4.0 は、当社の編集物（キュレーション、構成、表示）に適用されます

プールの内容について、率直に述べます。 プールされた回答は、サードパーティのモデルがサードパーティのウェブ検索結果から蒸留したものです。当社は、元となる事実や上流モデルの出力に対する所有権を主張しません。CC-BY-NC は当社の編集物に適用され、再利用には元のソースおよびモデルプロバイダーの利用規約も適用されます。プロバイダーの規約で求められる場合、一部のプロバイダー出力は再配布および将来のあらゆるトレーニングデータフィードから除外され、プロバイダーが義務付ける帰属表示も引き継がれます。フライホイールの有効性が確認されるまでは、トレーニングデータフィードは対象外です（ロードマップを参照）。このリポジトリでは、トレーニングデータのライセンス提供は行いません。

不正利用対策のしきい値（スクラブ、重複排除、品質調整）には、安全なサンプル用のデフォルト値が設定されています。本番環境の値はデプロイ時に注入され、このツリーには含まれません。そのため、ルールセットを公開しても、悪意のある利用者に悪用されることはありません。

ステータスとロードマップ

ゲート制のロードマップで、Gate 0 から Gate 4 まであります。Gate 0 は完了（ToS 監査、ニッチ、命名、ライセンスを確定済み）です。Gate 1 は進行中です。ゲートウェイ、セマンティックキャッシュ、公開フライホイールダッシュボードは構築済みで、実運用で試験済みです。合否を決めるテストは、ヒット率の曲線が上向きに転じることです。広告、課金、コミュニティコンピューティング、トレーニングデータフィードは、フライホイールの有効性が確認されるまで、明確に対象外です。