网页内容转飞书/ima文档#

将任意网页链接或本地文件一键转为结构化 Markdown，并保存到飞书云文档或腾讯 ima 笔记。

支持的信源#

信源URL 特征抓取方式X/Twitterx.com / twitter.comx-tweet-fetcher微信公众号mp.weixin.qq.commarkitdown-plusYouTubeyoutube.com / youtu.bemarkitdown-plus任意网页其他 http(s):// 链接markitdown-plus

本地文件支持#

类型扩展名PDF.pdfWord.docx / .docPowerPoint.pptx / .pptExcel.xlsx / .xls图片.png .jpg .jpeg .gif .webp音频.mp3 .wav .m4a .flac数据.csv .json .xml

输出目的地#

目的地环境变量说明Markdown 文件无默认选项，始终生成飞书云文档FEISHU_APP_ID + FEISHU_APP_SECRET参考 references/feishu-setup.md腾讯 imaIMA_CLIENT_ID + IMA_API_KEY云端 API，无需本地客户端，参考 references/ima-setup.md

安全配置#

⚠️ 凭证必须通过环境变量配置，禁止硬编码：

飞书配置#

bash

# 设置环境变量
$env:FEISHU_APP_ID = "your_app_id"
$env:FEISHU_APP_SECRET = "your_app_secret"

参考 references/feishu-setup.md 获取凭证。

ima 配置#

bash

# 设置环境变量
$env:IMA_CLIENT_ID = "your_client_id"
$env:IMA_API_KEY = "your_api_key"

参考 references/ima-setup.md 获取凭证。

工作流#

步骤 1：转换为 Markdown#

bash

python3 scripts/web_to_md.py --url "<url_or_path>" --output <output.md>

路由逻辑：

• X/Twitter → x-tweet-fetcher 抓取 JSON → tweet_to_md.py 结构化转换
• 其他所有 → markitdown-plus 直接转换

步骤 2：存入目的地#

飞书云文档

python

from scripts.feishu_client import FeishuClient

client = FeishuClient()
result = client.create_document(title="文档标题", content_md=markdown_content)
print(f"文档 URL: {result['url']}")

腾讯 ima

python

from scripts.ima_client import IMAClient

client = IMAClient()
result = client.create_note(title="笔记标题", content=markdown_content)
print(f"笔记 URL: {result['url']}")

验证连接#

bash

# 验证飞书
python scripts/feishu_client.py --action test

# 验证 ima
python scripts/ima_client.py --action test

故障处理#

问题解决方案x.com SSL 超时x-tweet-fetcher 使用 FxTwitter API 中转markitdown 模块丢失pip install markitdown微信反爬拦截markitdown 自动用移动端 UA 重试飞书凭证无效检查 FEISHU_APP_ID 和 FEISHU_APP_SECRETima 凭证无效检查 IMA_CLIENT_ID 和 IMA_API_KEY

依赖#

依赖安装markitdown-pluspip install markitdownx-tweet-fetcher克隆到 ~/.aily/workspace/skills/x-tweet-fetcherrequestspip install requestspython-dotenvpip install python-dotenv