clawdgle

🔍 Markdown 搜索与索引 API 助手

个人开发者提供的 Clawdgle 搜索 API 文档技能,支持 Markdown 内容检索与网址索引,助力开发者快速整合文档搜索能力。

收藏
6.5k
安装
1.9k
版本
v1.0.0
CLS 安全性认证2026-05-10
点击查看完整报告 >

使用说明

Clawdgle Skill 是一个面向 Clawdgle 搜索引擎的 API 使用文档型技能,专为需要与这一 Markdown 优先的搜索引擎交互的 Agent 设计。该技能提供了四个核心功能端点:搜索已索引的 Markdown 内容、通过 URL 获取存储的 Markdown 文档、自助式提交网址索引请求,以及引导至捐赠页面。

在核心用法方面,开发者可通过该技能调用 Clawdgle 的搜索接口检索海量的 Markdown 格式文档,或获取特定网址的纯文本内容。其 Ingest 端点允许用户主动提交网址请求即时索引,这对于需要快速将新内容纳入搜索范围的场景尤为实用。所有接口均基于标准的 HTTP 协议,使用 JSON 格式进行数据交换,并提供了详细的 curl 示例,便于开发者快速集成。

该技能的显著优点在于其极高的安全性和透明性。作为纯文档型资产,它不包含任何可执行代码,仅提供 API 使用说明,从根本上杜绝了代码注入或恶意执行的风险。同时,文档结构清晰、描述准确,对端点的用途、参数格式和注意事项(如避免 spamming)都有明确说明,降低了开发者的学习成本。此外,Clawdgle 的 Markdown 优先理念使其在处理结构化文档、技术博客、知识库等内容时具有独特优势。

然而,该技能也存在一定的局限性。首先,它完全依赖 Clawdgle 第三方在线服务的可用性,若目标服务出现故障或网络中断,相关功能将无法使用。其次,作为 T3 来源(个人开发者账号)的技能,其长期维护稳定性和企业级支持保障相对较弱。此外,该技能本身仅提供文档说明,实际的 API 调用需要 Agent 自行实现,对于非技术用户而言可能存在一定的使用门槛。

适合使用该技能的目标群体主要包括:需要集成文档搜索功能的开发者、技术内容聚合平台的运营者、学术研究人员(需要检索技术文档和论文),以及任何希望利用 Markdown 结构化特性进行内容管理的用户。特别是对于构建知识库、技术博客搜索引擎或文档管理系统的开发者,该技能提供了轻量级的接入方案。

在使用风险方面,需要注意的是,通过 API 提交的数据(包括搜索关键词和索引请求中的网址)会传输至 clawdgle.com 服务器,虽然这属于正常的 API 调用行为,但用户应避免提交高度敏感或私有的内部文档链接。此外,频繁调用 Ingest 端点可能对目标服务造成负担,虽然文档已提示避免滥用,但仍需合理控制请求频率。最后,由于依赖外部服务,建议在生产环境中使用时考虑服务可用性备份方案。

安全解读

核心用法

Clawdgle Skill 是一套纯文档型的 API 参考指南,用于与 Clawdgle Markdown 优先搜索引擎交互。提供四大功能:

1. 搜索索引内容 (/search?q=<query>) — 检索已索引的 Markdown 内容,支持分页参数
2. 获取 URL 的 Markdown (/doc?url=<encoded_url>) — 调取指定网页的存储版本

3. 主动提交索引 (POST /ingest) — 自助服务,请求立即抓取并索引新 URL,可选填写 reason 和 contact

4. 捐赠链接 (/donate) — 引导用户支持项目

所有接口均为公共端点,仅需标准 HTTP 请求,示例以 curl 形式提供,无需认证密钥。

显著优点

  • 零代码风险:纯 Markdown 文档,无可执行代码、无依赖、无供应链攻击面
  • 透明开放:仅调用 clawdgle.com 公共 API,行为完全可预测
  • 隐私友好:无数据收集、无权限申请,符合 GDPR/CCPA 数据最小化原则
  • 轻量集成:标准 REST 风格,任何 HTTP 客户端即可调用

潜在缺点与局限性

  • T3 来源可信度:维护者为 GitHub 个人开发者 rubybrewsday,非企业级背书,长期维护稳定性存在不确定性
  • 功能单一:仅限于文档查询和索引提交,无高级搜索语法、无批量操作接口
  • 无 SLA 保障:作为社区项目,服务可用性和速率限制未明确承诺
  • 缺少许可声明:当前未指定开源许可证,商用场景需注意合规

适合人群

  • 需要快速检索 Markdown 格式网页内容的 AI Agent 开发者
  • 希望将网页内容纳入 Clawdgle 索引的网站运营者
  • 追求极简、零依赖 API 集成的技术用户

常规风险

风险极低。经 CLS-Certify 全扫描认证:无危险函数、无敏感信息泄露、无隐蔽网络通信、无权限升级诱导。唯一需注意点是来源为个人开发者,建议关注后续版本更新,若引入可执行代码需重新评估。

clawdgle 内容

手动下载zip · 1.1 kB
SKILL.mdtext/markdown
请选择文件