crypt-librarian

用途：Crypt Librarian 是一个电影策展技能，用于推荐 2016 年之前、带有哥特/神秘学气质、文学质感与历史宏大感的影片，帮助用户建立观看清单或挑选 Criterion、MUBI 片单。其策展口味强调文学性、宗教/神秘体验、感官但不剥削、宏大而私人的叙事，以及实拍特效和从容节奏。\n\n主要能力：推荐前先读取本地档案 ~/Desktop/Programming/crypt-librarian/films.json，检查已有条目、评分、评论、待看队列和关联字段，再补充外部检索。使用 Perplexity 检索评论与主题分析（mcp__perplexity__search）；使用 Exa 做影片发现（scripts/exa_film_search.py，或 ~/.claude/skills/exa-search/scripts/ 下的 exa_search.py、exa_contents.py、exa_similar.py、exa_research.py 等），支持 search、contents、similar、research、--deep、--instant、--images、--output-schema 等模式；使用 Firecrawl CLI/API 抓取 Criterion、MUBI、Letterboxd、Senses of Cinema 等来源，支持 scrape、agent、parallel-agent、batch-scrape、extract、map、interact。多阶段流程包括口味校准、并行研究、候选验证、写入档案。\n\n使用方式：先澄清请求是情绪型还是具体主题，再查本地档案，继用 Perplexity、Exa、Firecrawl 检索，随后交叉过滤：确认 2016 年前、无 gore/酷刑、无动物虐待、无儿童虐待展示、无虐待性内容、非亚洲电影。输出格式为片名（年份）— 导演、契合理由、内容提示、观看渠道、预告片链接；预告片可经 Exa 搜 YouTube，海报经 fetch_posters.py（TMDB_API_KEY）生成。灵活模式脚本 scripts/flexible_discovery.py 可在用户要求 2016 年后、亚洲电影或其他类型时绕过过滤。自主代理可手动运行 python3 ~/Desktop/Programming/crypt-librarian/agent/crypt_librarian.py，并用 approve.py 审核候选。\n\n适用场景：寻找哥特浪漫、神秘学仪式、历史史诗、修正主义黑色电影、文学改编或宗教/神秘电影；也可用于建立带出处的观影清单。\n\n限制：需要本地档案、环境变量 EXA_API_KEY、TMDB_API_KEY 及 Python 依赖，这些均未在资料中给出安装步骤；分级、价格、平台可用性和效果未提供。