Meetup Planner

核心用法

Meetup Planner 是一款 AI 驱动的活动发现与追踪工具，通过整合 Brave Search 和 Firecrawl 两大 API，帮助用户自动化地搜索、筛选和管理感兴趣的线下活动。

使用流程：
1. 首次配置：自动检测并安装依赖技能（Firecrawl、Brave Search），引导用户配置 API 密钥，通过对话式访谈收集用户偏好（兴趣领域、地理位置、活动类型、时间偏好等）
2. 每日自动搜索：默认每日上午 8 点自动执行多维度搜索，抓取活动详情（名称、时间、地点、费用、报名链接）
3. 智能呈现：将新发现的活动格式化展示，支持用户标记「感兴趣」或「已报名」
4. 提醒系统：对已确认活动自动设置双重提醒（活动前 24 小时和 2 小时）

主要命令：update preferences（更新偏好）、show upcoming（查看待参加活动）、remove event [name]（移除追踪）、pause/resume search（暂停/恢复搜索）、search now（立即搜索）

显著优点

• 全自动化工作流：从搜索到提醒的完整闭环，无需手动刷 Meetup/Eventbrite
• 高度个性化：支持多维度偏好配置（技术领域、活动形式、时间投入、费用要求等）
• 数据主权：所有偏好、活动列表、提醒记录均存储在本地 ~/.claude/meetup-finder/，无云端上传
• 灵活可控：支持随时暂停/恢复搜索、修改偏好、即时触发搜索
• 智能信息提取：Firecrawl 深度爬取活动页面，自动提取结构化信息

潜在缺点与局限性

• API 依赖性强：功能完全依赖 Brave Search 和 Firecrawl 的可用性与配额，API 失效即功能中断
• 配置门槛：首次使用需手动申请并配置两个 API 密钥，对非技术用户不够友好
• 搜索覆盖盲区：依赖搜索引擎索引，可能遗漏小众社区、私域活动或刚发布的活动
• 时区与日程处理：未明确说明多时区支持，跨国用户需谨慎
• 提醒可靠性：基于本地 cron 任务，若设备休眠或进程终止可能导致提醒失效
• 无社交功能：不支持好友同步、活动分享、组队报名等协作场景

适合人群

• 技术从业者、创业者、自由职业者等需要持续拓展人脉网络的专业人士
• 热衷于参加行业会议、技术沙龙、工作坊的终身学习者
• 居住在活动资源丰富的一二线城市，面临「信息过载」选择困难的用户
• 注重隐私、偏好本地数据管理的用户

常规风险

• API 密钥泄露风险：密钥以环境变量或本地文件形式存储，需确保设备安全
• 第三方服务风险：Brave 和 Firecrawl 的服务条款变更、定价调整或停运将直接影响功能
• 活动信息准确性：依赖网页爬取，可能遇到过期链接、时间变更未同步等问题，重要活动建议二次确认
• 数据丢失风险：虽有自动备份机制，但本地存储仍面临设备故障、误删等风险

核心用法

Meetup Planner 是一款智能活动发现助手，通过多阶段协作帮助用户不再错过感兴趣的活动。首次运行时会引导完成三个关键配置：安装 Firecrawl 和 Brave Search 依赖技能、配置 API 密钥、通过对话式访谈收集个人偏好（活动类型、技术话题、地理位置、时间偏好等）。配置完成后，技能每日自动执行搜索流程——基于用户画像构建查询语句，调用 Brave Search 发现潜在活动，再经 Firecrawl 抓取详情页面提取完整信息，最终筛选去重后保存至本地数据库。

日常使用中，用户可通过自然语言指令管理活动：表达兴趣后技能会标记跟踪并提供注册链接，确认报名后自动设置双阶段提醒（24小时前和2小时前）。支持偏好更新、活动列表查看、暂停/恢复搜索等完整命令集，所有交互均通过 Agent 指令驱动完成。

显著优点

隐私优先设计：所有数据（用户偏好、活动列表、提醒配置）均存储于本地 ~/.claude/meetup-finder/ 目录，不上传至任何云服务，符合 GDPR 数据最小化原则。自动化程度高：一次配置后实现"设置即遗忘"，每日自动检索新活动并按用户作息推送，大幅降低信息搜寻的时间成本。灵活可定制：支持多维度偏好设置（技术领域、活动形式、时间投入、地理位置），查询策略动态生成，能精准匹配从 1 小时技术分享到多日黑客松的多元需求。开源透明：MIT 许可证托管于 GitHub，代码完全可审计，无黑盒算法或隐藏数据收集。

潜在缺点与局限性

外部 API 依赖：核心功能依赖 Brave Search 和 Firecrawl 两个商业 API，用户需自行注册获取密钥并承担调用费用，若服务中断或配额耗尽将导致搜索失效。本地化局限：数据不跨设备同步，多终端用户需手动迁移或备份配置文件。活动覆盖盲区：依赖公开索引的网页信息，对未上线主流平台的小型社区活动、私域群组活动存在遗漏可能。时区与地域挑战：全球化活动的时间换算、跨时区提醒逻辑未在文档中详细说明，国际用户可能遇到时间混淆。无社交功能：缺乏与其他参会者的互动机制、活动评价反馈系统，无法形成使用数据的正向循环优化推荐质量。

适合的目标群体

技术从业者持续学习者：需要跟踪行业会议、技术沙龙、工作坊以保持技能更新的开发者、产品经理、设计师。网络拓展需求者：主动寻求建立专业人脉的创业者、自由职业者、求职者，希望系统化管理潜在社交机会。活动密集型角色：开发者布道师、技术社区组织者、投资人等需要高频参会的职业人群。隐私敏感用户：不愿将个人兴趣数据托付给云端活动平台（如 Meetup.com、Eventbrite）的谨慎型用户。多兴趣交叉探索者：同时关注多个技术领域（如 AI/ML、区块链、设计系统），需要统一入口聚合分散信息的跨领域学习者。

使用风险与注意事项

API 成本与配额管理：自动化每日搜索可能快速消耗免费配额，建议用户监控用量并根据实际需求调整搜索频率或关键词范围。数据持久化风险：本地存储虽保障隐私，但设备故障、误删、系统重装会导致历史数据丢失，强烈建议用户定期备份 ~/.claude/meetup-finder/ 目录。环境配置复杂度：技能依赖 Node.js 生态的 npx 命令行工具，对非技术背景用户存在环境配置门槛，首次 setup 失败率较高。提醒可靠性：依赖系统 cron 或等效调度机制，若设备休眠、Agent 进程未运行或权限配置不当，可能导致提醒遗漏。信息时效性：从搜索到呈现的链路存在延迟，热门活动可能已售罄，建议对高优先级活动设置即时手动复核机制。