Lark API参考刮刀
Lark Open Platform的,之API复制引用文档Markdown格式保存的工具。已获取Markdown文件是Claude Code的,之library-mcp和集成,在程序开发时Lark API您可以轻松查找和浏览引用。
特徴
- 全面收集: Lark全部API自动收集文档(第31节,第291页)
- Markdown变换: HTML→Markdown自动变换
- 元数据添加:标题URL、分项,更新日期YAML frontmatter保存为
- Claude Code统合: library-mcp的Claude Code中单独提供
- 再実行対応:使用现有文件跳过功能防止重复
- 错误处理:自动重试,进度日志输出
获取的数据
此存储库已包含第291页的,之Lark API包含引用:
docs/
├── client-api/ (80ページ)
├── developer-guides/ (16ページ)
├── mcp/ (8ページ)
└── server-api-*/ (26セクション、195ページ)
├── server-api-lark-card/
├── server-api-messaging/
├── server-api-contacts/
├── server-api-calendar/
├── server-api-group-chat/
└── ...Claude Code使用方法
1. library-mcp整合
在这个项目中library-mcp中所述修改相应参数的值。可通过以下命令进行确认:
claude mcp listlibrary-mcp: ✓ Connected 查看项目中可用的所有族。
2.程序开发中的使用方法
Claude Code中委托任务“想制作~~那样的结构”的话Claude Code啊LLM的library-mcp使用Lark API自动查找引用,并提供适当的API中所述修改相应参数的值。
例:
- 「Lark我想建立自动发送信息的机制“
→ library-mcp信息API检索规格,自主制作发送程序
- “我想制作一个统一注册日历计划的脚本”
-日历API检查规格,实施事件创建处理
- 「Base“
→ Bitable API参考规格并生成记录插入代码
要点:
- API无需事先了解
- Claude Code必要时library-mcp的API查找引用
- 只是传达“想做什么”API的程序完成
library-mcp缺少信息:
Claude Code的library-mcp中找到所需信息时,请自行执行以下操作:
- 云雀开放平台符合API文档URL确认
config.yaml添加新分项python scraper_phase1_resume.py中选择新的扶手类型,来修改默认的扶手URL收集python scraper_phase2_new.py中所述修改相应参数的值- library-mcp自动索引新文件
- 根据取得的信息制作程序
此过程是完全自动化的,不需要用户干预。
3. Markdown文件结构
每个文件都包含以下元数据:
---
title: Get user_access_token
url: https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/authentication-management/access-token/get-user-access-token
section: server-api-calendar
last_updated: Last updated on 2025-06-09
---
# Get user_access_token
OAuth token API for acquiring the `user_access_token`...
## Request
HTTP Method: POST
HTTP URL: https://open.larksuite.com/open-apis/authen/v2/oauth/token
...重新刻划
要获取最新文档:
安装,安装
# 依存パッケージのインストール
pip install -r requirements.txt
# Playwrightブラウザのインストール
playwright install chromium実行方法
# Phase 1: URL収集(既存URLを避けて新規URLのみ収集)
python scraper_phase1_resume.py
# Phase 2: 新規URLのみスクレイピング
python scraper_phase2_new.py可选:
# 全ドキュメントを最初から取得(既存ファイルは自動スキップ)
python scraper.py --skip-existing
# ブラウザを表示して実行(デバッグ用)
python scraper.py --no-headless配置文件(config.yaml)
settings:
page_load_timeout: 10000 # ページ読み込みタイムアウト (ms)
request_delay: 1.0 # リクエスト間隔 (秒) - サーバー負荷軽減
max_retries: 3 # 最大リトライ回数
skip_existing: true # 既存ファイルをスキップ(重複防止)
headless: true # ヘッドレスモード
output_dir: docs # 出力ディレクトリ添加API文档检索方法
library-mcp中找到最佳实践Claude Code按照以下步骤自动执行刻划:
1.确定缺少的部分
Claude Code的library-mcp中找到最佳实践云雀开放平台文档URL中所述修改相应参数的值。
2. config.yaml添加节
不足的API的入口点URL的config.yaml添加到:
base_urls:
# 既存のセクション...
# 新規追加するセクション
- url: https://open.larksuite.com/document/[パス]
section: server-api-[セクション名]示例(如果添加了二进制API):
# Server API - Bitable (Base)
- url: https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/reference/bitable-v1/app-table-record/create
section: server-api-bitable3.新建URL收集(Phase1)
现有URL中选择新的扶手类型,来修改默认的扶手URL仅收集:
python scraper_phase1_resume.py因此url_list_new.json新建URL将条目添加到文档注册表。
4.新建URL刻划(Phase2)
python scraper_phase2_new.py新URL仅被刻划docs/保存在目录中。
5.结果确认
# 新規セクションのファイルを確認
ls -la docs/server-api-[セクション名]/
# library-mcpの接続を確認
claude mcp listlibrary-mcp自动索引新文件,无需重新启动。
常见附加节示例
- Bitable(基础) -数据库/表操作(已添加✅)
- 驾驶 -文件管理
- 维基 -知识库
- 搜索 -検索机能
- 表格 -电子表格操作
故障排除
library-mcp连接不上
# library-mcpを再追加
claude mcp add library-mcp -- uv --directory /tmp/library-mcp run main.py /Users/[ユーザー名]/Desktop/project/lark-apireference/docsPlaywright安装错误
# ブラウザの再インストール
playwright install --force chromium无法获取内容
--no-headless可选显示浏览器确认动作config.yaml的,之page_load_timeout增加- 检查网络连接
文件配置
scraper.py-主刮板(第一次全刮板)scraper_phase1_resume.py-新规URL收集(重复回避)scraper_phase2_new.py-新建URL仅刻划config.yaml-刮除器设置url_list.json-已收集URL(335个)docs/-已获取Markdown文件(311个)
技术仕样
- 刻划: Playwright(动态内容支持)
- HTML→Markdown变换:html2text
- 导航删除: BeautifulSoup4清除
- 検索统合:库mcp(克劳德代码mcp服务器)
注意事项
- 这个工具设想了个人的学习和开发用途
- 请注意刻划的频率Lark不要对服务器造成过大的负荷
config.yaml的,之request_delay的规格化距离的幂函数- 已获取Lark的文档Lark使用条款
许可证
这个工具MIT由许可证提供。但是,取得了Lark的文档Lark中所述修改相应参数的值。
统计情报
- 总页数:311个(Base追加后)
- 総URL数:335个
- 节数:32个(含Bitable)
- 最终更新日: 2025-10-29
获取的分项列表
- Client API (80页面)
- Developer Guides (16页面)
- Server API - 26章节(第195页)
- 消息、日历、联系人、任务、Bitable等。
- MCP (8页面)
