コード実行パターンを用いた効率的なマルチストラテジーZotero検索

Anthropic のコード実行パターンを実装する Zotero MCP 用の Python ライブラリは、コンテキストのオーバーフローやクラッシュなしで、安全で包括的な検索を有効にします。

##スキルインストール

##Claudeコード用

1. 本リポジトリのクローンまたはダウンロード 2。 [skill/フォルダをClaudeコードのスキルディレクトリにコピーします。

3。 スキルをロードするためにクロードコードを再起動します

クイックスタート

です! これは自動的に:

• ✅ semantic + キーワード + タグ検索を実行する
• ✅ 結果の重複
• ✅ 上昇によるランク
• ✅ コードに大きなデータセットをキープ(クラッシュなし)

複数条件検索

OR スタイルの検索(例、複数のスペルや言語)については、各用語を個別に検索し、マージします。

お問い合わせ Zotero は、複数の単語のクエリを AND 条件として扱います。 “Atayal 泰雅” を検索すると、BOTH 用語に一致する項目が見つかります。

なぜこの例

問題

直接MCPツールコールには制限があります。

• 大きい結果セット(>15-20項目)と*クラッシュリスク**
• ✨Token bloat - すべての結果はLMLのコンテキストに読み込まれます
• ✨**マニュアルの解釈 - 複数の検索
• ✨ランキングなし - 結果は関連性でソートされていません

Zotero Code Execution

Efficient multi-strategy Zotero search using code execution pattern

A Python library for Zotero MCP that implements Anthropic’s code execution pattern to enable safe, comprehensive searches without context overflow or crashes.

Skill Installation

For Claude Code

1. Clone or download this repository
2. Copy the skill/ folder to your Claude Code skills directory:

   cp -r skill ~/.claude/skills/zotero-mcp-code
   

3. Restart Claude Code to load the skill

Quick Start

import sys
sys.path.append('/path/to/zotero-code-execution')
import setup_paths
from zotero_lib import SearchOrchestrator, format_results

# Single comprehensive search - fetches 100+ items, returns top 20
orchestrator = SearchOrchestrator()
results = orchestrator.comprehensive_search("embodied cognition", max_results=20)
print(format_results(results))

That’s it! This automatically:

• ✅ Performs semantic + keyword + tag searches
• ✅ Deduplicates results
• ✅ Ranks by relevance
• ✅ Keeps large datasets in code (no crashes)

Multi-Term Searches

For OR-style searches (e.g., multiple spellings or languages), search each term separately and merge:

# Search for "Atayal" OR "泰雅族"
all_results = {}

for term in ['Atayal', '泰雅族']:
    results = orchestrator.comprehensive_search(term, max_results=50)
    for item in results:
        all_results[item.key] = item  # Deduplicate by key

# Re-rank combined results
ranked = orchestrator._rank_items(list(all_results.values()), 'Atayal 泰雅族')
print(format_results(ranked[:25]))

Why? Zotero treats multi-word queries as AND conditions. Searching “Atayal 泰雅族” finds items matching BOTH terms, not either term.

Why This Exists

The Problem

Direct MCP tool calls have limitations:

• 🚫 Crash risk with large result sets (>15-20 items)
• 🚫 Token bloat - all results load into LLM context
• 🚫 Manual orchestration - multiple searches, manual deduplication
• 🚫 No ranking - results not sorted by relevance

The Solution

Code execution keeps large datasets in the execution environment:

• ✅ No crashes - only filtered results return to context
• ✅ Token efficient - process 100+ items, return top 20
• ✅ Auto-orchestration - multi-strategy search in one call
• ✅ Auto-ranking - results sorted by relevance

Features

Multi-Strategy Search

One function call performs:

• Semantic search (multiple variations)
• Keyword search (multiple modes)
• Tag-based search
• Automatic deduplication
• Relevance ranking

Safe Large Searches

# ❌ Old way: Crash risk
results1 = zotero_semantic_search("query", limit=10)  # Limited to 10
results2 = zotero_search_items("query", limit=10)     # Another 10