zotero-code-execution
通过代码执行模式，安全高效地搜索Zotero文献库
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：zotero-code-execution。 它的用途是：通过代码执行模式，安全高效地搜索Zotero文献库 完整的 Skill 内容见：https://321skill.com/skills/zotero-code-execution/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我用 Zotero 全面搜索一下‘具身认知’（embodied cognition）相关的文献，找出最相关的20篇。” 它会调用 `SearchOrchestrator().comprehensive_search("embodied cognition", max_results=20)`，在后台执行多策略搜索并处理可能超过100条的数据，最终安全地返回排名前20的文献列表，并格式化成清晰的摘要供你参考。
介绍
Zotero Code Execution 是一个专为 Zotero MCP 设计的 Python 库，它解决了直接调用 MCP 工具进行文献搜索时遇到的常见痛点。当用户试图一次性获取大量文献时，传统的 MCP 调用容易因上下文溢出而导致 AI 应用崩溃，并且所有原始数据都会挤占宝贵的 Token 资源，效率低下。
该库巧妙运用了 Anthropic 的代码执行模式，将繁重的搜索、去重和排序逻辑放在安全的代码执行环境中完成。用户只需调用一个 comprehensive_search 函数，它就会自动执行语义搜索、关键词搜索和标签搜索等多种策略，获取超过100条结果，并在后台完成去重和相关性排序，最终只将最相关的少量结果（例如前20条）返回给 AI 上下文，整个过程安全无崩溃。
它非常适合需要深度挖掘 Zotero 文献库的学术研究者、高校学生以及任何需要撰写文献综述或技术报告的内容创作者。当您的研究主题复杂、需要查阅大量文献，但又担心 AI 因处理过多数据而崩溃或响应缓慢时，这个 Skill 是理想选择。
建议在 Claude Code 等支持代码执行的环境中使用。请注意，对于多义词或需要“或”逻辑的搜索（例如“Atayal OR 泰雅族”），建议拆分为多个独立搜索后再合并结果，因为 Zotero 默认将多词查询视为“与”关系。
核心特点
与直接调用 Zotero MCP 搜索工具相比，它通过代码执行环境处理海量中间数据，从根本上避免了因返回过多条目导致的 AI 崩溃和 Token 浪费问题，并内置了多策略搜索聚合与智能排序，用户无需手动组合多次调用。
注意事项
不适合仅需快速查看 Zotero 中少数几条最新条目的简单查询场景。
常见问题
这个 Skill 能防止 Claude 在处理大量 Zotero 数据时崩溃吗？
是的，它的核心设计就是将获取和过滤大量文献的过程放在代码执行环境中，只返回精简后的结果，从而避免上下文溢出导致的崩溃。
如何搜索包含多个同义词或不同语言表述的主题？
建议对每个术语（如‘Atayal’和‘泰雅族’）分别执行 `comprehensive_search`，然后将结果合并并去重，因为 Zotero 默认将空格分隔的词语视为‘与’(AND)关系。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/zotero-code-execution/raw/index.md 读取 zotero-code-execution 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/zotero-code-execution/raw/index.md（查看排版版本）