Hm Fetch Skill

Fetch Huawei HarmonyOS developer document正文 by calling documentPortal getDocumentById API with slug objectId, convert HTML content to Markdown, and maintain local-first migration references. Use when scraping Huawei HarmonyOS docs that are SPA-rendered and not directly readable by generic web fetchers.

aresbit 8b99911 1.5 KB Updated

File contents

HM Fetch Skill

Fetch HarmonyOS docs through API first, then fallback to generic fetch.

API-First Rule

Use API route first for正文:

  • Endpoint: https://svc-drcn.developer.huawei.com/community/servlet/consumer/cn/documentPortal/getDocumentById
  • Request body: {"objectId":"<slug>","language":"cn"}
  • Important: objectId is the document slug, not docId.

Scripts

  • Single page by slug:
    • python3 scripts/fetch_huawei_doc_api.py --slug typescript-to-arkts-migration-guide --out /tmp/doc.md
  • Preset migration pages:
    • python3 scripts/fetch_huawei_doc_api.py --preset migration --out-dir references/huawei-migration
  • One-shot refresh (API first, fallback to fetch-skill):
    • bash scripts/fetch_huawei_migration_refs.sh

Local-First Workflow

  1. Refresh local cache by bash scripts/fetch_huawei_migration_refs.sh.
  2. Answer questions from references/huawei-migration/*.md.
  3. Only if local cache is insufficient, refetch specific slug by API script.

Outputs

  • references/huawei-migration/01-arkts-migration-background.md
  • references/huawei-migration/02-typescript-to-arkts-migration-guide.md
  • references/huawei-migration/03-arkts-more-cases.md

aresbit/hm-fetch-skill/tree/main/ commit 8b99911d4c

Frequently asked questions

npx skillmds@latest add aresbit/hm-fetch-skill