Karakeep
Search Karakeep bookmarks, summarize saved articles, and organize links with notes and tags through AI.
Search saved links and notes, read available article content, and organize bookmarks with tags. Existing bookmarks can be checked before saving the same link again.
エージェントが Karakeep でできること
アクションをタスク別にまとめ、各グループに呼び出すアクションを記載しています。
Library Search and Reading
Find bookmarks and read their saved text, metadata, and highlights.
- List Bookmarks
- Search Bookmarks
- Get Bookmark
- Get Bookmark Content
- Get Bookmark Highlights
Bookmark Organization
Save links and notes, edit bookmark details, attach or remove tags, and maintain lists.
- Check Bookmark Url
- Create Bookmark
- Update Bookmark
- Attach Tags To Bookmark
- Detach Tags From Bookmark
- List Lists
- Create List
エージェントに任せられるタスク
かっこ内を埋め、タスクに 2 つ目のアプリがあればそれも接続してください。
Summarize Saved Articles
Search your library and read article content in manageable sections for a source-based summary.
Find saved articles about [topic] in Karakeep. Read the relevant content and summarize their arguments with links.
Save and Tag a New Link
Check whether a URL is already saved before creating a link bookmark and attaching tags.
Save [link] with title [title], note [note], and tags [tags]. If already saved, show the existing bookmark and leave it unchanged.
アクション55
Karakeep コネクタが提供するすべてのアクションを、名前と ID で掲載しています。
- Get Current User
get_current_userGet the profile of the Karakeep user that owns the connected API key, including name, email and avatar. - Get Current User Stats
get_current_user_statsGet usage statistics for the Karakeep user that owns the connected API key, including bookmark, tag, list and asset counts. - List Bookmarks
list_bookmarksList the bookmarks of the connected Karakeep user, optionally filtered by archived or favourited status, sorted by creation date and paged with a cursor. Keep includeContent false unless the extracted page content is really needed, because it can make the response very large; text bookmarks always carry content.text. - Create Bookmark
create_bookmarkCreate a bookmark from a link, a text note or an already uploaded asset. Set type to link and provide url, set type to text and provide text, or set type to asset and provide assetType and assetId. When the same URL is already bookmarked Karakeep does not create a duplicate: it returns the existing bookmark with alreadyExists set to true and re-saves it, which bumps createdAt to now, resets archived to false, and overwrites title, favourited, note and summary with whatever you supplied. Only source rss and source import skip that re-save. Call check_bookmark_url first when the existing bookmark must not be touched. - Search Bookmarks
search_bookmarksSearch the bookmarks of the connected Karakeep user with full text, semantic or hybrid search. Paging uses a search specific cursor that cannot be shared with list_bookmarks. Keep includeContent false unless the extracted page content is really needed, because it can make the response very large; text bookmarks always carry content.text. - Check Bookmark Url
check_bookmark_urlCheck whether a URL is already bookmarked and return the id of the existing bookmark, or null when it is not. Useful before calling create_bookmark. - Get Bookmark
get_bookmarkGet a single bookmark with its tags, content and attached assets. Keep includeContent false unless the extracted page content is really needed, because it can make the response very large; text bookmarks always carry content.text. Use get_bookmark_content to read long article text in chunks. - Update Bookmark
update_bookmarkUpdate a bookmark. Only the fields you send are changed, and sending null clears a nullable field, so existing values are overwritten. Fields that do not belong to the bookmark variant are not ignored: Karakeep rejects the whole request with a 400 such as Attempting to set link attributes for non-link type bookmark and writes nothing, so send only the fields that match the bookmark type. - Delete Bookmark
delete_bookmarkPermanently delete a bookmark together with its tags, highlights and attached assets. - Get Bookmark Content
get_bookmark_contentRead the readable content of a bookmark in chunks as markdown or plain text. This is the safe way to read long articles: pass nextCursor back to fetch the following chunk instead of asking for the whole content with includeContent. Karakeep rejects a cursor with CONTENT_CHANGED when the bookmark content changed while paging, in which case restart from the first chunk. - Summarize Bookmark
summarize_bookmarkGenerate an AI summary for a link bookmark and return it. Karakeep saves the generated summary on the bookmark, replacing any summary it already had, and re-indexes the bookmark for search, so this is not a read-only preview. The call blocks while the configured model runs, so it can take a while, and it fails with an invalid input error when the Karakeep instance has no inference provider configured. The current server writes the summary before answering and returns it synchronously, so summary normally carries the finished text. The published OpenAPI spec instead documents the whole bookmark record, so an instance following that shape can answer with summary null; in that case read the bookmark again with get_bookmark until summarizationStatus is success and take the summary from there. - Attach Tags To Bookmark
attach_tags_to_bookmarkAttach tags to a bookmark. Reference each tag by tagId, or by tagName to let Karakeep create the tag when it does not exist yet. - Detach Tags From Bookmark
detach_tags_from_bookmarkDetach tags from a bookmark. Reference each tag by tagId or by tagName. The tags themselves are kept, only the attachment to this bookmark is removed. - Get Bookmark Lists
get_bookmark_listsList the Karakeep lists that contain a bookmark. - Get Bookmark Highlights
get_bookmark_highlightsList the highlights stored on a bookmark. - Attach Asset To Bookmark
attach_asset_to_bookmarkAttach an already uploaded asset to a bookmark, for example a screenshot or a PDF. Upload the file first to obtain an asset id. Only the screenshot, pdf, assetScreenshot, precrawledArchive, bannerImage, video and userUploaded roles can be attached; linkHtmlContent, bookmarkAsset, fullPageArchive, avatar and unknown assets are maintained by Karakeep itself and are rejected with a 400. - Replace Asset On Bookmark
replace_asset_on_bookmarkReplace an asset that is attached to a bookmark with another already uploaded asset. The replaced asset is deleted and the new asset takes over its role. The asset being replaced must hold an attachable role, meaning screenshot, pdf, assetScreenshot, precrawledArchive, bannerImage, video or userUploaded; assets Karakeep maintains itself, including linkHtmlContent, bookmarkAsset, fullPageArchive, avatar and unknown, are rejected with a 400. - Detach Asset From Bookmark
detach_asset_from_bookmarkDetach an asset from a bookmark. Karakeep deletes the asset record together with the stored file, so the asset id becomes unusable afterwards and the bytes are gone; the bookmark keeps its other assets. Only screenshot, pdf, assetScreenshot, fullPageArchive, precrawledArchive, bannerImage, video and userUploaded assets can be detached; linkHtmlContent, bookmarkAsset, avatar and unknown assets are maintained by Karakeep itself and are rejected with a 400. - List Lists
list_listsRetrieve all bookmark lists for the authenticated Karakeep user, including both manual and smart lists. This endpoint is not paginated and returns every list in one response. - Create List
create_listCreate a new bookmark list. Manual lists receive bookmarks that are added explicitly, while smart lists are populated automatically by a saved search query.
Karakeep のサインイン方法
- サインイン方法
- API キーConnect a full-access Karakeep API key, optionally with your public instance URL.
- 必要なもの
- A Karakeep API key; an accessible public instance URL if using self-hosting.
- 備考
- Karakeep-generated summaries require an inference provider on the instance and replace the bookmark’s saved summary. Semantic search depends on instance configuration.