Alibaba Cloud Product + API Discovery

---

name: alicloud-platform-openapi-product-api-discovery

description: Discover and reconcile Alibaba Cloud product catalogs from Ticket System, Support & Service, and BSS OpenAPI; fetch OpenAPI product/version/API metadata; and summarize API coverage to plan new skills. Use when you need a complete product list, product-to-API mapping, or coverage/gap reports for skill generation.

version: 1.0.0

---

# Alibaba Cloud Product + API Discovery

Follow this workflow to collect products, resolve API metadata, and build summaries for skill planning.

Workflow

1) Fetch product lists from the three sources

Run the bundled scripts (from this skill folder):

python scripts/products_from_ticket_system.py
python scripts/products_from_support_service.py
python scripts/products_from_bssopenapi.py

Provide required env vars in each script (see references).

2) Merge product lists

python scripts/merge_product_sources.py

This writes `output/product-scan/merged_products.json` and `.md`.

3) Fetch OpenAPI metadata product list

python scripts/products_from_openapi_meta.py

This writes `output/product-scan/openapi-meta/products.json` and `products_normalized.json`.

4) Fetch OpenAPI API docs per product/version

python scripts/apis_from_openapi_meta.py

By default this can be large. Use filters for dry runs:

5) Join products with API counts

python scripts/join_products_with_api_meta.py

6) Summarize products by category/group

python scripts/summarize_openapi_meta_products.py

6) (Optional) Compare products vs existing skills

python scripts/analyze_products_vs_skills.py

Output discipline

All generated files must go under `output/`. Do not place temporary files elsewhere.

Validation

mkdir -p output/alicloud-platform-openapi-product-api-discovery
for f in skills/platform/openapi/alicloud-platform-openapi-product-api-discovery/scripts/*.py; do
  python3 -m py_compile "$f"
done
echo "py_compile_ok" > output/alicloud-platform-openapi-product-api-discovery/validate.txt

Pass criteria: command exits 0 and `output/alicloud-platform-openapi-product-api-discovery/validate.txt` is generated.

Output And Evidence

Prerequisites

References