核心用法
mjzj-msg 是卖家之家（mjzj.com）官方为跨境电商卖家打造的私信管理技能，通过标准化 API 接口实现站内信的全流程管理。该技能提供三大核心功能：查询私信会话列表（支持未拉黑/已拉黑分类筛选）、获取与指定用户的完整聊天记录（基于消息 ID 游标分页）、以及向特定用户发送私信（含 VIP 配额校验）。
使用时需在环境变量中配置 MJZJ_API_KEY，所有接口通过 Authorization: Bearer 方式进行鉴权。会话查询采用偏移量分页（position 字符串），消息查询采用游标分页（messageId 字符串），发送消息时需严格使用 recieverUserSlug 和 content 字段名。技能对雪花 ID 全程保持字符串处理，避免 JavaScript 等环境下的精度丢失问题。
显著优点
官方背书，来源可信：由卖家之家商业平台官方团队维护，T2 级来源可信度，非个人开发者匿名作品，具备完整的商业平台技术支撑。
纯文档零代码风险：本技能为纯 Markdown 文档型技能，无任何可执行代码、动态脚本或第三方依赖，从根本上杜绝了代码执行、供应链攻击等安全风险。
API 设计规范严谨：严格遵循 RESTful 规范，分页机制清晰（偏移量 vs 游标），字段命名一致，错误码处理完善（401/403/409 分级提示），业务错误文案可直接透传。
数据安全合规：仅与卖家之家官方域名通信，全链路 TLS 1.2+ 加密，不静默收集用户数据，符合 GDPR/CCPA 隐私保护要求。
潜在缺点与局限性
功能边界明确：仅覆盖私信查询与发送三大接口，不包含用户搜索、批量消息管理、消息模板、自动回复等进阶功能，复杂场景需组合其他工具。
商业功能限制：发送私信存在 VIP 权限校验和每日配额限制，非 VIP 用户或超额调用会触发业务阻断，不适合大规模自动化营销场景。
依赖平台生态：完全绑定卖家之家账号体系，无法跨平台使用；若平台 API 升级或策略调整，技能需同步更新文档。
无实时推送能力：采用主动轮询模式获取新消息，无 WebSocket 或回调机制，实时性取决于调用频率，高频查询可能触及速率限制。
适合的目标群体
跨境电商运营人员：需要集中管理多店铺站内信、跟进客户询盘的亚马逊/速卖通等平台卖家。
客服团队协作场景：多人共享会话视图，查询历史记录以保障服务连贯性，避免信息断层。
自动化工作流集成者：将私信查询嵌入 CRM 或 ERP 系统，实现客户沟通记录的数字化归档。
合规敏感型用户：对数据安全有较高要求，倾向于使用官方背书、零第三方依赖的工具方案。
使用风险与注意事项
API 密钥安全：MJZJ_API_KEY 是访问凭证，若泄露可能导致私信数据被读取或恶意发送。建议存储于密钥管理系统，定期轮换（建议 90 天周期），禁止提交至版本控制。
配额与限流风险：发送接口存在 VIP 等级限制和每日次数上限，业务代码 unvip 或频率超限会返回 409 错误，自动化脚本需内置重试与退避逻辑。
权限边界风险：401 错误表明密钥失效或过期，403 表明账号无接口权限，需引导用户至 https://mjzj.com/user/agentapikey 重新配置，切勿降级使用网页搜索猜测结果。
数据隐私责任：虽技能本身不存储数据，但用户通过 API 获取的私信内容属于敏感信息，需自行承担数据保管责任，避免在日志中明文记录消息内容。