Next.js 16 官方文档完整嵌入，覆盖 App Router、Server Components、Server Actions、缓存策略与部署指南，前端工程化的权威参考。

基本信息

• 技能名称?NextJS 16+ Complete Documentation
• 中文名称?Next.js 16 官方文档全量嵌入
• 作者?leonaaardob
• 分类?专业技能
• 版本?16.1.6
• 标签?nextjs, react, ssr, ssg, app-router, server-components, server-actions, frontend, full-stack, typescript, vercel, documentation

使用方法

使用说明
核心功能
Next.js 16 Skill 将官方完整文档以结构化 Markdown 形式嵌入，涵盖两大架构体系：现代的 App Router （基于 React Server Components）与兼容遗留的 Pages Router 。支持最新特性包括流式 SSR、Server Actions、增量静态再生成（ISR）及 Turborepo 优化构建。
显著优势
权威性 ：直接同步官方 v16.2.0-canary.30 文档，API 引用与最佳实践零延迟
全场景覆盖 ：从项目初始化、路由设计、数据获取到生产部署、PWA、静态导出完整闭环
双轨制导航 ：清晰区分 App Router 与 Pages Router，迁移指南（Vite/CRA/旧版 Next.js）降低升级成本
工程化深度 ：SWC 编译器、缓存策略矩阵、环境变量管理、测试集成（Jest/Vitest/Playwright/Cypress）一应俱全
潜在局限
版本时效性 ：canary 版本文档存在漂移风险，生产环境需与 stable 版本交叉验证
框架锁定 ：深度绑定 Next.js 生态，跨框架迁移成本需额外评估
服务端复杂度 ：Server Components 心智模型较 CSR 显著提高，新手易混淆渲染边界
适合人群
React 全栈开发者、需要 SSR/SSG 架构决策的技术负责人、从 CRA/Vite 迁移至生产级框架的团队。
常规风险
缓存误用 ：默认 aggressive caching 可能导致数据过期，需显式配置 revalidate/tag
Server Actions 安全 ：表单提交缺乏 CSRF 防护时需自行实现 origin 校验
自托管陷阱 ：Docker 部署需注意 Node 版本与 sharp 依赖，静态导出限制动态 API 路由

实时联网浏览与信息检索工具，支持URL内容提取、网页搜索与结构化数据抓取，快速获取最新在线信息

基本信息

• 技能名称?Web Browsing
• 中文名称?实时联网·秒搜全网信息
• 作者?tankebuaa
• 分类?其他
• 版本?1.0.0
• 标签?web-search, url-fetch, content-extraction, real-time-data, information-retrieval, browsing

使用方法

使用说明
核心用法
web-browsing 是一项互联网信息获取技能，提供三种核心能力：

1. 直接URL访问 ：访问指定网页并提取主要内容，适用于用户分享链接后的内容解析
2. 网页搜索 ：基于关键词执行全网检索，返回相关结果摘要
3. 结构化数据提取 ：从目标网站抓取特定信息（如新闻头条、产品价格等）
   显著优点
   时效性强 ：突破训练数据时间限制，获取实时信息
   覆盖广泛 ：可访问任意公开网页，扩展知识边界
   场景灵活 ：支持从快速概览到深度数据挖掘的多层次需求
   零配置 ：无需API密钥或复杂设置，直接调用
   潜在缺点与局限性
   | 限制类型 | 具体说明 | |---------|---------| | 动态内容 | 无法执行JavaScript，可能错过单页应用(SPA)的交互内容 | | 访问屏障 | 部分网站启用反爬虫机制，导致内容获取失败 | | 媒体支持 | 无法播放视频/音频，仅能描述页面文本提及的多媒体信息 | | 认证内容 | 无法访问登录保护的页面（需凭证的场景不适用） | 适合人群
   需要追踪实时新闻、股价、赛事结果的资讯型用户
   研究特定网站内容（论文、文档、产品页）的学习者
   验证信息真伪、交叉比对多来源的事实核查场景
   常规风险
   信息可靠性 ：来源网站质量参差不齐，需用户自行判断可信度
   隐私暴露 ：访问行为可能被目标站点记录（常规HTTP请求痕迹）
   内容时效幻觉 ：抓取快照非实时流，高频更新页面可能存在延迟

通过 Maton 托管 OAuth 安全连接 WooCommerce，统一管理商品、订单、客户、优惠券等全链路电商运营，无需自建鉴权基础设施。

基本信息

• 技能名称?WooCommerce
• 中文名称?托管 OAuth 一站式电商运营中枢
• 作者?byungkyu
• 分类?专业技能
• 版本?1.0.4
• 标签?woocommerce, e-commerce, api, oauth, product-management, order-management, inventory, crm, automation, maton

使用方法

使用说明
核心用法
WooCommerce skill 提供对 WooCommerce REST API 的完整封装，通过 Maton 代理服务实现托管式 OAuth 认证。用户只需配置 MATON_API_KEY 环境变量，即可调用商品、订单、客户、优惠券、物流、税费、报表及 Webhooks 等全量接口。
认证流程 ：

1. 在 maton.ai 获取 API Key
2. 创建 WooCommerce 连接并跳转授权 URL 完成 OAuth
3. 所有请求通过 Authorization: Bearer $MATON_API_KEY 头部鉴权
4. 多店铺场景可通过 Maton-Connection 头部指定目标店铺
   典型场景 ：
   商品管理 ：批量创建/更新商品、管理变体与属性、分类标签维护
   订单处理 ：查询订单状态、更新订单进度、处理退款与备注
   客户运营 ：客户数据同步、地址管理、下载权限查看
   促销配置 ：创建限时优惠券、设置折扣规则与使用限制
   数据洞察 ：获取销售报表、热销排行、库存统计
   显著优点
5. 零 OAuth 基建成本 ：Maton 托管完整的 OAuth 流程，开发者无需处理 token 刷新、密钥存储等安全敏感操作
6. 完整 API 覆盖 ：支持 WooCommerce REST API v3 全部资源端点，涵盖电商运营全生命周期
7. 多店铺灵活切换 ：单 API Key 可管理多个 WooCommerce 店铺连接，通过头部指定目标店铺
8. 标准化接口格式 ：保持原生 WooCommerce API 的 URL 结构与响应格式，降低迁移成本
9. 批量操作支持 ：商品、订单、税费等资源均支持 batch 批量创建/更新/删除，提升数据处理效率
   潜在缺点与局限性
10. 网络依赖性强 ：完全依赖 Maton 代理服务，若服务不可用则无法访问 WooCommerce 数据
11. 数据隐私顾虑 ：订单、客户等敏感数据流经第三方代理，需评估合规要求
12. 延迟增加 ：相比直连店铺 API，多一层代理可能引入额外网络延迟
13. 功能边界限制 ：仅支持标准 REST API 端点，自定义 WooCommerce 插件扩展的 API 可能无法访问
14. 速率限制不透明 ：Maton 层可能存在未公开的请求频率限制，大促场景需提前验证
    适合人群
    电商 SaaS 开发者 ：快速集成多店铺 WooCommerce 数据，无需维护 OAuth 基础设施
    运营自动化团队 ：构建订单处理、库存同步、促销管理的自动化工作流
    数据分析场景 ：定期拉取销售报表、客户数据进行 BI 分析
    多渠道零售商 ：统一管理 WooCommerce 与自有系统的商品与订单数据
    常规风险
    | 风险类型 | 说明 | 缓解建议 | |---------|------|---------| | 密钥泄露 | MATON_API_KEY 泄露可导致账户数据被访问 | 使用环境变量注入，禁止硬编码；定期轮换密钥 | | 误操作数据 | 批量更新/删除可能造成不可逆数据丢失 | 生产操作前先在沙箱验证；关键操作要求用户二次确认 | | OAuth 授权过期 | 店铺授权撤销或过期导致连接失效 | 监控连接状态，设置授权过期预警 | | 数据同步延迟 | 代理层缓存或网络问题导致数据不一致 | 关键业务场景增加数据校验机制 |

通过托管 OAuth 集成 Mailchimp Marketing API，支持受众管理、邮件营销自动化、模板制作及效果分析，适合企业级邮件营销场景。

基本信息

• 技能名称?Mailchimp
• 中文名称?自动化邮件营销，一站托管接入
• 作者?byungkyu
• 分类?专业技能
• 版本?1.0.4
• 标签?email-marketing, mailchimp, automation, crm, audience-management, campaign-analytics, oauth-integration

使用方法

使用说明
概述
Mailchimp Skill 是由 Maton 提供的官方集成服务，通过托管 OAuth 代理访问 Mailchimp Marketing API 3.0，为用户提供完整的邮件营销自动化能力。该技能无需自行处理复杂的 OAuth 流程，仅需配置 MATON_API_KEY 即可快速接入。
核心功能
受众管理（Lists） ：创建、更新、删除邮件列表，管理订阅者信息、标签与细分
营销活动（Campaigns） ：设计邮件内容、设置发送参数、调度或立即发送、获取发送报告
模板系统（Templates） ：创建自定义 HTML 模板，支持动态内容区块
自动化工作流（Automations） ：构建基于触发条件的自动邮件序列，支持启动/暂停控制
数据分析（Reports） ：获取打开率、点击率、退订率等核心指标，支持 180 天历史数据查询
批量操作（Batches） ：高效处理大规模订阅者导入或更新
显著优点

1. 零 OAuth 配置 ：Maton 托管 OAuth 流程，用户只需完成浏览器授权即可使用
2. 完整 API 覆盖 ：支持 Mailchimp Marketing API 绝大部分功能端点
3. 多账户支持 ：通过 Maton-Connection 头部可管理多个 Mailchimp 账户
4. 开发友好 ：提供 Python、JavaScript 等多语言示例，文档详尽
   潜在局限
   代理层依赖 ：所有请求经由 api.maton.ai 中转，存在单点故障风险
   写入操作需确认 ：根据安全策略，创建、更新、删除操作需显式用户批准，可能增加交互步骤
   超时限制 ：API 调用 120 秒超时，大规模批量操作需拆分处理
   速率限制 ：受 Mailchimp 官方 API 限制（通常 10 并发/秒）
   适合人群
   中小型企业营销团队
   SaaS 产品用户运营人员
   需要自动化邮件触发的开发者
   数据分析师（获取邮件营销效果数据）
   常规风险
   数据隐私 ：订阅者邮箱、姓名等 PII 数据流经第三方代理
   权限管理 ：需妥善保管 MATON_API_KEY ，避免泄露导致账户被滥用
   合规风险 ：邮件营销需遵守 CAN-SPAM、GDPR 等法规，技能本身不提供合规检查
   误操作风险 ：批量删除或更新操作不可逆，建议操作前备份数据

通过 Maton 代理安全接入 Klaviyo API，实现邮件营销自动化、客户数据管理与电商运营全链路打通，支持 OAuth 托管与多账户切换

基本信息

• 技能名称?Klaviyo
• 中文名称?托管 OAuth 接入 Klaviyo 全功能营销 API
• 作者?byungkyu
• 分类?专业技能
• 版本?1.0.5
• 标签?email-marketing, ecommerce, automation, api-gateway, customer-data, oauth, crm, analytics

使用方法

使用说明
核心用法
Klaviyo Skill 是 Maton 平台提供的托管式 API 代理服务，让用户无需直接处理 Klaviyo OAuth 认证即可调用完整的营销自动化接口。核心工作流为：获取 Maton API Key → 创建/管理 Klaviyo OAuth 连接 → 通过 https://api.maton.ai/klaviyo/{path} 代理调用原生 API。
关键能力覆盖：
客户数据管理 ：Profiles（画像增删改查、合并、列表/分群关联）、批量导入/订阅管理
受众组织 ：Lists（静态列表）、Segments（动态分群）的 CRUD 与成员管理
营销执行 ：Campaigns（邮件/短信活动创建、发送、效果预估）、Flows（自动化流程状态管理）
事件追踪 ：Events（行为事件上报、批量创建）、Metrics（指标聚合查询）
内容资产 ：Templates（邮件模板）、Catalogs（商品目录）、Images（图片资源）、Universal Content（内容块）
运营工具 ：Coupons（优惠券码管理）、Webhooks（事件推送配置）、Reviews（评价管理）、Forms（订阅表单）
认证架构 ：采用双层凭证——Maton API Key 作为平台网关认证，Klaviyo OAuth Token 由 Maton 自动注入，支持多账户隔离（通过 Maton-Connection 头部指定）。
显著优点

1. OAuth 免运维 ：无需自建 OAuth 应用、处理 token 刷新或 scope 管理，Maton 托管连接状态
2. 全功能覆盖 ：完整透传 Klaviyo 2026-01-15 版本 API，包括批量操作（Bulk Import/Subscription）和聚合分析（Metric Aggregates）
3. 多租户友好 ：单 Maton 账户可管理多个 Klaviyo 连接，适合代运营、多品牌场景
4. 请求简化 ：统一入口 api.maton.ai ，自动处理版本头（ revision ）和认证注入
5. 安全缓冲 ：写操作需用户显式确认，降低误操作风险
   潜在缺点与局限性
6. 依赖 Maton 平台可用性 ：Klaviyo 原生 API 变更需等待 Maton 适配，存在滞后风险
7. 流量与速率限制 ：受 Maton 网关和 Klaviyo 双重限流（Klaviyo 采用 fixed-window 算法）
8. Flow 创建受限 ：API 创建 Flow 能力有限，复杂自动化需先在 Klaviyo UI 配置后管理
9. 数据驻留疑虑 ：客户数据流经 Maton 代理，对合规敏感型企业需评估数据主权
10. 调试复杂度 ：双层架构下，401/403 错误需区分是 Maton Key 问题还是 Klaviyo OAuth 失效
11. URL 编码陷阱 ： fields[] 、 page[] 等参数在 curl 中需 -g 禁用 glob，管道传参时环境变量可能失效
    适合人群
    DTC 品牌运营团队 ：需批量管理邮件列表、自动化欢迎/弃购流程
    电商技术团队 ：Shopify/WooCommerce 等平台的 Klaviyo 深度集成需求
    营销自动化顾问 ：代运营多客户账户，需快速切换不同 Klaviyo 工作区
    数据分析师 ：拉取 Metrics 聚合数据进行离线 BI 分析
    SaaS 集成开发者 ：构建基于 Klaviyo 的上层应用，避免 OAuth 基础设施投入
    常规风险
    误操作群发 ：Campaign 发送前务必调用 Recipient Estimation 确认受众规模
    隐私合规 ：批量导入 Profiles 时需确保 consent 字段合法（GDPR/CCPA）
    Coupon 格式限制 ： external_id 仅允许 alphanumeric + 下划线，含连字符将报错
    Token 过期 ：长期运行的自动化任务需监控连接状态，及时重新授权
    数据泄露 ：Maton API Key 泄露将导致所有托管连接暴露，需妥善保管