freek.dev

为AI工具提供博客内容管理的REST API

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:freek.dev。
它的用途是:为AI工具提供博客内容管理的REST API
完整的 Skill 内容见:https://321skill.com/skills/freek-dev/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“调用freek.dev的API,创建一篇关于‘AI Agent开发’的博客草稿,内容用Markdown格式,并打上‘人工智能’和‘开发’的标签。”,它会根据你提供的标题、正文和标签等参数,构造带有认证令牌的HTTP POST请求,发送到`/api/posts`端点,从而在你的博客后台创建一篇新文章。

介绍

freek.dev 提供了一个受保护的REST API,专门用于程序化地管理博客文章内容。它解决了AI工具或自动化脚本需要与博客平台进行结构化数据交互的问题,例如批量创建、更新或查询文章。

通过 Sanctum 令牌认证,该API允许授权用户(通常是管理员)执行完整的CRUD操作。用户可以使用GET请求获取文章列表或单篇文章,通过POST创建新文章,用PUT更新现有内容,或用DELETE移除文章。所有请求都需要在HTTP头部携带有效的Bearer令牌。

这个Skill非常适合需要将内容创作或管理流程自动化的开发者、内容运营团队或AI应用开发者。例如,开发一个能自动发布技术博客的AI助手,或者构建一个集中管理多个内容源的后台工具。

使用前,请确保你拥有目标博客站点的管理员权限以生成访问令牌。注意API的响应数据被统一包装在data键下,且支持通过查询参数进行过滤和搜索,这在进行批量操作时非常高效。

核心特点

与通用内容管理API不同,它专为博客场景深度定制,原生支持Markdown文本、文章系列、自动推文等博客特性,并且通过Laravel Sanctum提供了简洁而安全的令牌认证机制。

注意事项

仅适用于基于freek.dev源码构建的博客站点,不适用于其他通用CMS平台。

常见问题

如何获取API访问令牌?

需要在目标站点的Tinker环境中,使用管理员账号执行`$user->createToken('ai-tool')`来生成一次性令牌。

能批量导出所有博客文章吗?

可以,通过调用`GET /api/posts`接口,并合理处理分页数据,即可获取所有文章列表。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/freek-dev/raw/index.md 读取 freek.dev 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。