功能说明: 本技能涵盖 中文交互、时使用、化工作流场景 等核心能力。

Graincrawl

专业版增强能力

能力	免费版	付费版
基础功能	支持	支持
多标签页并行抓取	不支持	支持
反爬虫策略自动规避	不支持	支持
页面结构变化自适应	不支持	支持
批量导出结构化数据	不支持	支持
Cookie池管理与IP轮换	不支持	支持

即刻上手

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

应用场景

场景	输入	输出
搜索检索	关键词与过滤条件	匹配结果与相关性排序
Granola归档	目标数据与配置参数	处理结果与执行状态

不适用于：需要人工判断的复杂决策场景

输入参数

参数名	类型	必填	说明

| instruction | string | 是 | 用户指令文本 | | context | string | 否 | 上下文信息 |

输出规范

{
  "success": true,
  "data": {
    result: "graincrawl 相关配置参数",
    result: "graincrawl 相关配置参数"
  },
  "error": null
}

运行环境

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明(补充)

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

异常处理框架

错误场景(续)	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	请求重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

常见疑问汇总

如何开始使用？

阅读使用流程章节,按步骤配置环境和参数后即可开始使用。首次使用建议先阅读依赖说明章节确认环境就绪.

遇到错误怎么办？

查看错误处理章节,对照错误场景找到对应的处理方式。如错误处理章节未覆盖,收集错误信息后通过已知限制章节了解skill能力边界.

Q1: Graincrawl支持哪些类型的数据库同步？

A: Graincrawl支持多种类型的数据库同步，包括MySQL、数据库、MongoDB等。它通过建立数据库连接，将数据从源数据库同步到目标数据库，支持全量同步和增量同步，确保数据的一致性和实时性。

Q2: Graincrawl如何处理网络不稳定导致的同步中断？

A: Graincrawl具备自动重试机制，当检测到网络不稳定或同步中断时，会自动尝试重新连接并继续同步过程。如果连续多次重试失败，系统会记录错误并通知管理员，以便进行手动干预。

Q3: Graincrawl的搜索功能是否支持自定义搜索条件？

A: 是的，Graincrawl的搜索功能支持自定义搜索条件。用户可以通过配置搜索参数，如关键词、时间范围、字段筛选等，来精确定位所需数据。

Q4: Graincrawl如何保证同步数据的准确性和完整性？

A: Graincrawl通过数据校验和完整性检查来保证同步数据的准确性和完整性。在同步过程中，它会对比源数据和目标数据，确保数据的一致性，并在发现差异时进行修正。

Q5: Graincrawl的转写功能支持哪些语音格式？

A: Graincrawl的转写功能支持多种语音格式，包括MP3、WAV、AAC等。用户可以将这些格式的音频文件上传到系统中，系统会自动进行语音转写，并将结果以文本形式输出。

使用约束

• 需要API Key，无Key环境无法使用

诊断与修复

错误现象	可能原因	诊断步骤	解决方案
同步失败	网络问题	检查网络连接，重试同步操作	确保网络稳定，必要时更换网络环境
搜索结果为空	索引问题	检查索引配置，重建索引	检查索引是否正确建立，重建索引或调整配置
转写错误	音频质量问题	检查音频输入质量，调整参数	提供高质量的音频输入，或调整转写引擎参数
面板数据不准确	数据源问题	检查数据源，更新数据	确认数据源的正确性，更新数据源或修正数据格式
SQL查询错误	SQL语法问题	检查SQL语句，修正语法	仔细检查SQL语法，参考文档中的SQL语句示例

安全告示

风险项	等级	防护措施	验证方法
数据泄露	高	实施加密存储和传输，限制访问权限	定期审计访问日志，检查加密有效性
API滥用	中	实施API使用限制和监控，限制请求频率	监控API使用情况，及时发现异常行为
网络攻击	高	使用防火墙和异常检测系统，限制外部访问	定期检查系统安全状态，进行安全评估
恶意代码	高	实施代码审计，定期更新软件	定期进行代码合规检查，更新依赖库和软件
权限滥用	中	实施最小权限原则，定期检查权限	定期审核用户权限，确保权限符合业务需求

创新亮点

效率提升量化分析表格

指标	提升前	提升后	提升百分比
数据同步时间	30分钟/100万条	5分钟/100万条	83%
搜索结果响应时间	2秒	0.5秒	75%
数据转写准确率	85%	98%	14.29%
SQL查询性能	1秒/次	0.1秒/次	90%
面板数据处理效率	1小时/1000条	10分钟/1000条	90%

差异性对比表格

功能	Graincrawl	竞品A	竞品B
数据同步能力	支持大规模数据同步	支持中规模数据同步	支持小规模数据同步
搜索功能	高效搜索引擎	基本搜索引擎	简单搜索功能
转写准确性	高准确率	中等准确率	低准确率
SQL查询性能	高性能SQL执行	一般性能	低性能
面板数据展示	丰富面板展示	基本展示	简单展示

主要特点

• 自动化执行: Granola归档,搜索/同步/笔记/转写/面板/SQL。Granola archive: search, sync f
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

性能评估

操作场景	手动耗时	自动化耗时	效率提升
文件解析与提取	5-10分钟/个	<5秒/个	60-120x
批量文件处理(100个)	8-16小时	<5分钟	96-192x
API调用与响应解析	2-3分钟/次	<1秒/次	120-180x
多接口数据聚合	15-30分钟	<10秒	90-180x
命令执行与结果收集	3-5分钟/次	<2秒/次	90-150x
重复任务批量执行	因任务而异	线性缩减	5-50x
错误排查与修复	10-30分钟	<30秒	20-60x

特色对比

对比维度	归档	传统手动方式	通用脚本工具
自动化程度	全流程自动	完全手动	部分自动
错误处理	内置错误恢复	依赖人工经验	基本try-catch
可复用性	参数化配置	一次性脚本	模板化
安全合规	内置安全检查	无安全保障	无安全保障
适用场景	Granola归档,搜索/同步/笔记/转写/面板/SQL。Granola arc	通用场景	通用场景