Karakeep
通过 AI 搜索 Karakeep 书签、总结收藏文章，并用笔记和标签整理链接。
搜索收藏链接与笔记、阅读可用文章正文，并用标签整理书签；再次保存同一链接前可检查已有收藏。
Agent 能在 Karakeep 里做什么
按任务分组，每组列出要调用的操作。
收藏搜索与阅读
查找书签，读取已保存正文、资料和高亮。
- List Bookmarks
- Search Bookmarks
- Get Bookmark
- Get Bookmark Content
- Get Bookmark Highlights
书签整理
保存链接和笔记、编辑书签资料、添加或移除标签，并维护列表。
- Check Bookmark Url
- Create Bookmark
- Update Bookmark
- Attach Tags To Bookmark
- Detach Tags From Bookmark
- List Lists
- Create List
可以交给 Agent 的任务
方括号里填你的内容，任务标出的其他应用也要连接。
总结收藏文章
搜索收藏，并分段读取文章内容，结合来源生成摘要。
在 Karakeep 查找关于 [主题] 的收藏文章，阅读相关内容并总结观点，附上链接。
保存并标记新链接
先检查链接是否已收藏，再创建链接书签并添加标签。
保存 [链接]，标题为 [标题]，笔记为 [笔记]，添加 [标签]；如果已收藏，展示已有书签并保持原样。
操作55
Karakeep 连接器提供的全部操作，附名称和 id。
- Get Current User
get_current_user获取连接所用 Karakeep API 密钥所属用户的资料，包括名称、邮箱和头像。 - Get Current User Stats
get_current_user_stats获取连接所用 Karakeep API 密钥所属用户的使用统计，包括书签、标签、列表和资源数量。 - List Bookmarks
list_bookmarks列出当前连接的 Karakeep 用户的书签，可按归档或收藏状态筛选，按创建时间排序并用游标翻页。除非确实需要抓取到的正文，否则保持 includeContent 为 false，因为返回体可能非常大；文本书签始终会带上 content.text。 - Create Bookmark
create_bookmark从链接、文本笔记或已上传的资源创建书签。type 为 link 时传 url，为 text 时传 text，为 asset 时传 assetType 和 assetId。当同一个 URL 已经被收藏时，Karakeep 不会创建重复项：它会返回已存在的书签并把 alreadyExists 置为 true，同时重新保存该书签，把 createdAt 更新为当前时间、把 archived 重置为 false，并用你传入的值覆盖 title、favourited、note 和 summary。只有 source 为 rss 或 import 时会跳过这次重新保存。如果不希望已存在的书签被改动，请先调用 check_bookmark_url。 - Search Bookmarks
search_bookmarks在当前连接的 Karakeep 用户的书签中做全文、语义或混合搜索。翻页使用搜索专用游标，不能与 list_bookmarks 共用。除非确实需要抓取到的正文，否则保持 includeContent 为 false，因为返回体可能非常大；文本书签始终会带上 content.text。 - Check Bookmark Url
check_bookmark_url检查一个 URL 是否已被收藏，返回已存在书签的 id，未收藏时返回 null。适合在调用 create_bookmark 之前使用。 - Get Bookmark
get_bookmark获取单个书签，包含它的标签、内容和附加资源。除非确实需要抓取到的正文，否则保持 includeContent 为 false，因为返回体可能非常大；文本书签始终会带上 content.text。要分段读取长文正文，请使用 get_bookmark_content。 - Update Bookmark
update_bookmark更新书签。只有传入的字段会被修改，传 null 会清空对应的可空字段，因此原有内容会被覆盖。与书签变体不匹配的字段不会被忽略：Karakeep 会以 400 拒绝整个请求，例如 Attempting to set link attributes for non-link type bookmark，并且什么都不写入，所以只传与书签类型匹配的字段。 - Delete Bookmark
delete_bookmark永久删除一个书签，同时删除它的标签、高亮和附加资源。 - Get Bookmark Content
get_bookmark_content以 markdown 或纯文本分段读取书签的可读内容。这是读取长文的安全方式：把 nextCursor 传回来获取下一段，而不是用 includeContent 一次性取回全文。如果翻页过程中书签内容发生变化，Karakeep 会以 CONTENT_CHANGED 拒绝游标，此时需要从第一段重新开始。 - Summarize Bookmark
summarize_bookmark为链接书签生成 AI 摘要并返回。Karakeep 会把生成的摘要保存到书签上，覆盖它原有的摘要，并重建该书签的搜索索引，所以这不是只读预览。调用期间会阻塞等待所配置的模型运行，可能耗时较长；当 Karakeep 实例没有配置推理服务时会返回 invalid_input 错误。当前服务端会先写入摘要再应答并同步返回，因此 summary 通常带有最终文本。已发布的 OpenAPI 规范则声明返回整条书签记录，遵循该形状的实例可能返回 summary 为 null；这种情况下请用 get_bookmark 反复读取书签，直到 summarizationStatus 为 success，再从中取出摘要。 - Attach Tags To Bookmark
attach_tags_to_bookmark给书签附加标签。每个标签用 tagId 指定，或者用 tagName 指定，让 Karakeep 在标签不存在时自动创建。 - Detach Tags From Bookmark
detach_tags_from_bookmark从书签上移除标签。每个标签用 tagId 或 tagName 指定。标签本身会保留，只解除与该书签的关联。 - Get Bookmark Lists
get_bookmark_lists列出包含指定书签的 Karakeep 列表。 - Get Bookmark Highlights
get_bookmark_highlights列出书签上保存的高亮。 - Attach Asset To Bookmark
attach_asset_to_bookmark把已经上传的资源附加到书签上，例如截图或 PDF。需要先上传文件拿到资源 id。只有 screenshot、pdf、assetScreenshot、precrawledArchive、bannerImage、video 和 userUploaded 这些角色可以被附加；linkHtmlContent、bookmarkAsset、fullPageArchive、avatar 和 unknown 由 Karakeep 自己维护，附加时会被判 400。 - Replace Asset On Bookmark
replace_asset_on_bookmark用另一个已上传的资源替换书签上已附加的资源。被替换的资源会被删除，新资源接替它的角色。被替换的资源必须属于可附加角色，即 screenshot、pdf、assetScreenshot、precrawledArchive、bannerImage、video 或 userUploaded；由 Karakeep 自己维护的资源，包括 linkHtmlContent、bookmarkAsset、fullPageArchive、avatar 和 unknown，会被判 400。 - Detach Asset From Bookmark
detach_asset_from_bookmark从书签上移除一个资源。Karakeep 会同时删除资源记录和已存储的文件，因此该资源 id 之后不再可用，字节内容也一并消失；书签的其他资源保持不变。只有 screenshot、pdf、assetScreenshot、fullPageArchive、precrawledArchive、bannerImage、video 和 userUploaded 可以被移除；linkHtmlContent、bookmarkAsset、avatar 和 unknown 由 Karakeep 自己维护，移除时会被判 400。 - List Lists
list_lists获取当前 Karakeep 用户的全部书签列表，包含手动列表和智能列表。该接口不分页，一次返回所有列表。 - Create List
create_list创建一个新的书签列表。手动列表只包含显式添加的书签，智能列表则由保存的搜索查询自动填充。
Karakeep 怎么登录
- 登录方式
- API Key使用有完整访问权限的 Karakeep API Key 连接，可提供自己的公开实例地址。
- 需要准备
- Karakeep API Key；自托管时还需公开可访问的实例地址。
- 说明
- 使用 Karakeep 生成摘要需要实例配置推理服务，并会替换书签已保存的摘要。语义搜索取决于实例配置。