kungfu

The KUNGFU software agent skill provides a robust interface for interacting with your centralized bookmark repository at KUNGFU.SH. Designed for power users, researchers, and developers, this tool bridges the gap between stored web content and automated data processing. By leveraging your personal KUNGFU.SH API key, the agent gains authorized access to your saved content, enabling you to integrate bookmark retrieval directly into AI-driven research pipelines, automated reporting workflows, or personal knowledge dashboards. It acts as an abstraction layer over your stored links and social media saved items, allowing for rapid retrieval based on semantic or keyword-based criteria.

• Perform keyword-based search queries to find relevant information across large bookmark collections with relevance-ranked results.

• Filter retrieved data by specific sources, such as X, or by content authors to narrow down information silos.

• Retrieve full detail views for specific bookmarks to extract metadata, original content snippets, and source identifiers.

• Generate summary statistics for your bookmarking habits, including counts by source and identification of frequently cited authors.

• Integration support for standard authentication headers using Bearer tokens for secure API interaction.

• To begin, set the KUNGFU_API_KEY environment variable with a key generated from your KUNGFU.SH settings page.

• Default API behavior targets https://kungfu.sh, but the base URL can be overridden using the KUNGFU_BASE_URL environment variable for local instances or proxy setups.

• The search function accepts a limit parameter to control response payloads, with a maximum limit of 100 entries per request.

• Inputs typically involve a string-based search query and optional filters like @handle for author attribution or source-specific flags.

• Expected outputs are structured JSON objects containing bookmark metadata, including content bodies, author details, and associated media URLs.

• Ensure your environment is configured for HTTPS communication to maintain security when transmitting authentication tokens.