用途：通过托管的 Stashr MCP 服务器（https://stashr.me/mcp）或官方 CLI（@stashr/cli）操作用户私有的 Stashr 收藏库，适用于搜索、浏览、统计、查看图片与保存整理书签。
主要能力：渐进式检索（先搜索或浏览，最多返回 10 条紧凑结果，保留 ID、媒体引用、来源 URL 和 nextCursor，仅对需要的结果批量获取全文）；用 stats 回答数量与概览问题，不做翻页计数；按平台（instagram、reddit、tiktok、twitter、web、youtube）、内容类型、作者、标签、采集日期、媒体类型过滤；图片搜索与短名单查看。
使用方式：每个会话只解析一次传输方式并复用：若已连接 Stashr MCP 服务器则使用它；否则在可用 shell 时运行一次 stashr whoami --json，成功后改用 CLI。不要重复检查两种传输，也不要让用户在聊天中粘贴 API 密钥。检索时按序进行，避免逐条获取同一短名单；cursor 仅在相同命令、查询、过滤和状态下有效，变动即从第一页重来；搜索排名覆盖约前 200 个候选，应靠过滤收窄而非深翻页。
修改库：仅在请求或明确必要时变更，成功需以传输确认为准；保存 URL 幂等；归档可逆且支持批量；集合是保存的过滤器，删除前需明确确认，且删除集合不会删除其书签。
权限与错误：读权限覆盖发现、检索、统计和账号信息；写权限覆盖保存与整理；删除集合还需 destructive 权限。错误会说明是否可重试（retryable、retryAfterMs）；限流按提示退避，不可重试的错误不要重试。认证或权限失败时说明缺失的具体权限并请用户重新连接，不要静默切换账号。payment_required（402）表示需要 Stashr Pro 计划或有效试用，应检查账号计划与试用状态，引导访问 https://stashr.me/settings/billing，不要重试。