코드 실행 패턴을 사용하여 효율적인 다중 전략 Zotero 검색

Anthropic의 코드 실행 패턴을 구현하는 Zotero MCP에 대한 파이썬 라이브러리는 컨텍스트 오버 플로우 또는 충돌없이 안전하고 포괄적 인 검색을 가능하게합니다.

기술 설치

Claude 코드

1. Clone 또는 다운로드 이 저장소

2. skill/] 폴더를 Claude Code 기술 디렉토리에 복사하십시오.

3. 기술을 적재하는 Restart Claude 부호

빠른 시작

그것은! 이 자동적으로:

• ✅ semantic + 키워드 + 태그 검색 수행
• ✅ 결과를 Deduplicates
• ✅ 등급
• ✅ 코드에 큰 데이터 세트를 유지 (크래치 없음)

멀티터엠 검색

OR-style 검색을 위해 (예를들면, 여러 철자 또는 언어), 각 용어를 별도로 검색하고 병합하십시오.

왜? Zotero는 다중 단어 쿼리와 조건을 취급합니다. 검색 "Atayal A"는 BOTH 용어 일치하는 항목을 찾을 수 없습니다.

왜 이 존재

문제

직접 MCP 도구 통화에는 제한이 있습니다.

• rating ** 충돌 위험 ** 큰 결과 세트 (> 15-20 항목)
• rating Token bloat - 모든 결과는 LLM 컨텍스트로로드됩니다.
• rating ** 수동 deduplication
• 2007-11-13 ** 순위 없음 ** - relevance에 의해 분류되지 않는 결과

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