Clawdgle

核心用法

Clawdgle Skill 封装了四个公开 REST 端点，允许用户与 Clawdgle 搜索引擎进行交互：

1. 搜索 (`/search`)：通过 q 参数查询已索引的 markdown 内容，支持分页控制（page、per_page）。
2. 文档抓取 (`/doc`)：传入编码后的 URL，获取系统存储的原始 markdown 内容。
3. 索引提交 (`/ingest`)：通过 POST 请求主动提交 URL，请求系统立即索引该页面，支持可选的备注与联系方式。
4. 捐赠引导 (`/donate`)：重定向至捐赠页面，用于支持项目运营。

显著优点

• 零认证门槛：所有端点均为公开 API，无需 API Key 或 OAuth，降低接入成本。
• Markdown 原生：返回内容与索引均以 markdown 为核心格式，适合 AI Agent 处理、知识库构建等场景。
• 自服务索引：ingest 端点允许用户主动推送内容，缩短内容收录周期。
• 轻量级设计：接口简洁，参数直观，适合快速脚本集成与自动化工作流。

潜在局限

• 无速率限制说明：文档未明确标注限流策略，高频调用存在被限流或封禁的隐性风险。
• 无身份验证：公开端点虽便利，但无法追踪调用方身份，亦无法保证数据隐私（请求参数明文传输）。
• 功能边界模糊：未说明索引覆盖范围、更新频率及内容审核机制，结果一致性难以预估。
• 依赖外部服务：Clawdgle 本身为第三方平台，其可用性与数据持久性不受调用方控制。

适合人群

• 需要快速检索公开网页 markdown 内容的开发者与研究者
• 构建轻量级知识库、RAG 系统的 AI Agent 开发者
• 希望主动将自有内容纳入搜索引擎的内容创作者

常规风险

• 数据泄露风险：通过 ingest 提交的 URL 与联系方式若包含敏感信息，可能被日志记录。
• 服务稳定性风险：作为新兴/小众服务，Clawdgle 可能面临运维资源不足导致的间歇性不可用。
• 内容合规风险：返回的 markdown 内容未经本地过滤，可能包含不符合特定场景要求的信息。

核心用法

Clawdgle Skill 为纯文档型工具，提供四项核心功能的 API 调用指南：

1. 内容搜索（/search）：通过 GET 请求检索已索引的 Markdown 内容，支持分页参数 page 和 per_page，适用于快速定位公开网页的文本信息。

2. Markdown 获取（/doc）：根据 URL 获取对应的 Markdown 归档版本，便于内容复用、离线阅读或知识库构建。

3. 自助索引（/ingest）：支持向 Clawdgle 提交 URL 请求即时索引，适合需要主动收录特定网页内容的场景。可附带可选的索引原因和联系方式字段。

4. 捐赠支持（/donate）：快速跳转至项目捐赠页面，便于社区化运营的资金支持。

所有端点均基于 HTTPS 通信，调用方式以标准 curl 示例呈现，无需复杂鉴权流程。

显著优点

• 零代码依赖：纯 Markdown 文档结构，无可执行脚本或运行时依赖，部署与审计成本极低。
• 即开即用：仅需基础 HTTP 客户端即可调用，无需 SDK 或复杂的身份认证体系。
• Markdown 优先：原生支持 Markdown 格式输出，与知识管理、文档协作场景高度契合。
• 自助索引能力：打破传统搜索引擎被动等待爬虫的模式，用户可主动触达索引流程。
• 完全透明：端点功能、参数含义、调用示例均清晰文档化，无隐藏行为。

潜在缺点与局限性

• 功能边界明确：仅覆盖搜索、获取、索引、捐赠四类基础能力，无高级筛选、批量操作或结果排序等扩展功能。
• 无官方 SDK：需自行封装 HTTP 请求，对于非技术用户存在一定门槛。
• 索引延迟不确定：Ingest 端点虽支持即时索引请求，但实际生效时间取决于服务端调度策略，文档未明确 SLA。
• 依赖外部服务：所有功能均指向 clawdgle.com 域名，若服务不可用则 Skill 失效。
• 来源可信度待观察：维护者为个人开发者（rubybrewsday），长期维护能力与商业稳定性存在不确定性。

适合的目标群体

• 知识管理用户：需要将网页内容转为 Markdown 归档至个人知识库（如 Obsidian、Notion）的群体。
• 轻量级搜索需求者：偏好简洁 API、拒绝复杂企业级搜索方案（如 Elasticsearch）的开发者或小团队。
• 内容创作者：希望主动推送文章至搜索引擎索引、提升内容曝光效率的博主或技术写作者。
• 隐私敏感用户：追求最小权限原则、不愿授权第三方复杂权限的谨慎型用户。

使用风险

• 服务可用性风险：Clawdgle 为社区项目，无企业级 SLA 承诺，存在单点故障可能。
• Ingest 滥用风险：若高频提交无价值 URL 或敏感私有链接，可能导致 IP 封禁或数据泄露。
• 内容合规风险：获取的 Markdown 内容版权归属原始网页，商用需自行确认授权条款。
• 版本兼容性风险：当前 Skill 基于 v1.0.0 文档构建，若官方 API 变更而未同步更新，可能导致调用失败。
• 无审计日志：Skill 本身不记录操作日志，问题排查需依赖 Clawdgle 服务端日志配合。