feishu-doc-finder_skill

Overview

This skill locates and downloads files from Feishu chat history by filename. It is designed to recover attachments that were missed by automated download processes or to retrieve older files from a specific chat. It runs from the command line and requires Feishu API credentials in the environment.

How this skill works

The skill authenticates to Feishu using FEISHU_APP_ID and FEISHU_APP_SECRET, then queries the specified chat's message history for attachments matching the filename. It supports a configurable history window (hours) to limit the search and downloads the matching file to a specified output directory. If multiple matches exist, it lists them so you can choose which to download.

When to use it

• A missed or failed automated download left a file inaccessible locally.
• You need to retrieve an older attachment from a specific Feishu chat.
• Verifying backups by searching conversations for specific filenames.
• Quickly extracting a single file without navigating the Feishu UI.
• Scripting periodic retrievals for archiving purposes.

Best practices

• Set FEISHU_APP_ID and FEISHU_APP_SECRET as environment variables before running.
• Run with a sufficient lookback hours value to include the likely message window.
• Specify an output directory to keep downloads organized and avoid overwrites.
• Check chat_id and filename for exactness; partial matches may return multiple results.
• Use in a secure environment and rotate credentials according to your security policy.

Example use cases

• Recover a travel-planner.zip that failed to download from a team chat yesterday.
• Search a project chat for a specific contract.pdf from the last week for archival.
• Automate nightly retrievals of exported reports posted to a group chat.
• Quickly locate and download a single attachment needed for an urgent review.
• Audit historical messages for files matching sensitive filename patterns.