페이슈(Lark) 문서 스크래퍼
페이슈/Lark 문서·위키·합집(컬렉션)·스프레드시트·묘기(회의록) 전사를 원문 그대로 로컬 마크다운으로 추출하는 스킬.
문서·오피스고급★ 1,323⑂ 212AI 점수 8/10마지막 업데이트: 2026. 8. 8.
무엇을 해주나
- 페이슈/Lark URL(위키 노드, docx, 시트, Minutes/妙记)을 판별해
lark-cliAPI로 본문을 프로그래밍적으로 내려받습니다. 모델이 본문을 다시 쓰거나 요약하지 못하게 막아 원문 충실도를 지킵니다. - 합집(허브 문서)이면
<mention-doc>,<sheet>,<image>, 크로스 테넌트 링크 등 참조 그래프를 BFS로 재귀 추적해 말단 문서까지 모두 수집합니다. - 권한 거부(131006 등)는 서버 측 경계로 인정하고, 소유자가 내보낸
.docx를 충실히 변환하는 경로(폰트 크기→제목,w:shd→하이라이트 복원)로 우회합니다. - Minutes(묘기)는 네이티브 전사 API를 사용하며, 음성을 다시 ASR 돌리는 것을 금지합니다.
- 종료 조건이 명확합니다: 미해결 리치미디어 태그 grep 비어 있음, U+FFFD 없음, docx는 이미지로 렌더해 시각 검증, frontmatter에
source기록, 권한/이미지 누락은 사용자에게 명시.
이런 분께 추천
- 페이슈/Lark를 사내 위키로 쓰면서 문서를 옵시디언 등 로컬 지식베이스로 옮기려는 분
- 여러 문서가 얽힌 지식베이스 합집을 누락 없이 통째로 아카이브해야 하는 분
- 회의록(묘기) 전사를 정확한 화자·타임스탬프와 함께 텍스트로 보관해야 하는 분
- 전제:
lark-cli(npm@larksuite/cli) 설치 및 대상 테넌트 인증, docx 경로는python-docx와 pandoc 등
활용 예시
- "이 飞书 wiki 합집 전체를 마크다운으로 내려줘" → 위키 노드 토큰을 doc 토큰으로 해석 후 재귀 추출, 마지막에 잔여 태그 검사로 누락 확인.
- "이 묘기 링크 전사본만 뽑아줘" → device-flow로 추가 스코프를 받아 네이티브 전사 엔드포인트 호출.
- "권한이 없어서 안 열리는 문서" → 131006 확인 후 소유자에게 .docx 내보내기 요청, 받은 파일을 제목 계층·하이라이트까지 복원해 변환.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/feishu-doc-scraper/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 daymade/claude-code-skills 의 feishu-doc-scraper 폴더를 내 ~/.claude/skills/feishu-doc-scraper/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/daymade/claude-code-skills.git && mkdir -p ~/.claude/skills && cp -r claude-code-skills/feishu-doc-scraper ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 스킬 저장소를 클론합니다:
git clone https://github.com/daymade/claude-code-skills.git - 스킬 폴더를 Claude Code 스킬 경로로 복사합니다:
mkdir -p ~/.claude/skills && cp -r claude-code-skills/feishu-doc-scraper ~/.claude/skills/ - 주 경로용 CLI를 설치합니다:
npm i -g @larksuite/cli(검증 버전 1.0.32) lark-cli로 대상 테넌트에 로그인/인증합니다. Minutes 전사가 필요하면 device-flow 로그인으로 추가 스코프를 승인합니다.- 중국 본토 도메인 프록시 우회를 위해 셸에
export LARK_CLI_NO_PROXY=1을 설정합니다(권장: 셸 설정 파일에 추가). - docx 경로를 쓸 계획이면
pip install python-docx와pandoc을 설치합니다. - Claude Code를 재시작하고 "이 飞书 문서를 마크다운으로 추출해줘" + URL을 입력하면 스킬이 발동합니다.
GitHub에서 원본 보기 ↗라이선스: MIT