mcpField
B
bitrix-search

bitrix-search

github.com/bxmaximum開発4778 回インストール2 週間前に更新
リポジトリ

bitrix-search について

Bitrix の旧式 `CSearch*` API で検索機能を実装する開発者向けのガイドです。モジュールの初期化、インデックス作成、再インデックス、権限、検索エンジンの動作を説明します。

主な機能

  1. 01エンティティとフィールドのインデックス化
  2. 02権限と削除の処理
  3. 03再インデックスハンドラーの登録
  4. 04`CSearch::Search()` による検索
  5. 05検索エンジンの設定

活用シーン

  1. 01独自エンティティを Bitrix 検索に追加
  2. 02全体またはモジュール単位の再インデックス処理
  3. 03検索権限や URL の問題の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-search

インストール後、Claude Code で/bitrix-searchを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

rules/
engines.md
indexing.md
reindex.md
searching.md

詳細

Bitrix 検索モジュール

ベースライン:main 23.0+ · 検証済み:search 25.200.0、main 26.800.0

すべてのエディション(Site Management と Bitrix24)に含まれています。レガシー API のみです。CSearch* クラスを使用し、lib/、D7、ORM レイヤー、コンソールコマンドはありません。

タスク参照先
独自のエンティティ、フィールド、権限のインデックス作成、削除、BeforeIndexrules/indexing.md
OnReindex ハンドラー、全体/モジュール単位の再インデックス、CLI、手順rules/reindex.md
search.page/search.title、CSearch::Search()、権限、URL フックrules/searching.md
Sphinx/OpenSearch/MySQL/PgSQL エンジン、ステミング、カスタムランキング、静的ファイルrules/engines.md

不変条件

  • CSearch* を呼び出す前に必ず Loader::includeModule('search') を実行してください。モジュールが存在しない、またはインストールされていない場合があるため、インデックス作成によって書き込みが失敗しないようにしてください。
  • /local/modules/<vendor.module>/ 内の単一のサービスを介して CSearch を使用してください。エンティティのイベントと OnReindex ハンドラーの両方で、同じフィールドビルダーを使ってこのサービスを呼び出します。
  • インデックスキーは(MODULE_ID、ITEM_ID)です。iblock や main ではなく、必ず独自のモジュール ID を使用してください。
  • 必ず SITE_ID、PERMISSIONS、DATE_CHANGE を渡してください。権限のないアイテムは管理者にのみ表示されます。G2 は匿名ユーザーを含む全員を意味します。
  • search:OnReindex は、実行時の addEventHandler() ではなく、インストーラーでモジュール ID とともに永続的に登録してください。
  • Web コンテキストから検索してください。CSearch::Search() には $USER が必要で、エージェントでは致命的エラーが発生します。

コメント