← Back to Skills Marketplace
78
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install apmzoom-gds
Description
APM 플랫폼의 상품 관리 API 모음. 관리자용 상품 추가/삭제/수정/가격·재고·할인 관리 17개 + 사용자용 상품 조회/검색/카테고리/추천/유사 상품/이미지 검색 16개, 총 33개 엔드포인트. 모든 엔드포인트는 먼저 ids_*_login으로 access_token 획득 후 a...
README (SKILL.md)
APM 상품 관리 API
APM 플랫폼의 상품 관리 API 모음. 관리자용 상품 추가/삭제/수정/가격·재고·할인 관리 17개 + 사용자용 상품 조회/검색/카테고리/추천/유사 상품/이미지 검색 16개, 총 33개 엔드포인트. 모든 엔드포인트는 먼저 ids_*_login으로 access_token 획득 후 authcode 헤더(HH + token)로 호출. last_update_time 커서 페이지네이션 사용. 중국어/한국어 키워드 검색 지원.
공통 규약
- Base URL:
https://44k2t5n59e.execute-api.ap-northeast-2.amazonaws.com - 요청 헤더:
v=7.0.1,p=1,t=\x3Cunix초>,lang=zh-cn - 인증 헤더:
authcode: "HH " + access_token(로그인 계열 제외) - 서명:
sign = MD5(\x3Cparams> + \x3Csalt>).toUpperCase()— 엔드포인트별 salt는 각 문서 참조 - 성공 코드:
code=100, 결과는result필드 - 페이지네이션:
last_update_time커서 방식,page_size=20
엔드포인트 목록 (33개)
gds_m_addgoods— 상품 정보 추가[판매자] ·POST /gds/app/m_addgoodsgds_m_delgoods— 상품 정보 삭제[판매자] ·GET /gds/app/m_delgoodsgds_m_editgoods— 상품 정보 수정[판매자] ·POST /gds/app/m_editgoodsgds_m_editgoodsdiscount— 상품 할인 수정[판매자] ·POST /gds/app/m_editgoodsdiscountgds_m_editgoodsdiscountprice— 상품 할인 가격 수정[판매자] ·POST /gds/app/m_editgoodsdiscountpricegds_m_editgoodsprice— 상품 가격 수정[판매자] ·POST /gds/app/m_editgoodspricegds_m_editgoodssell— 상품 진열 상태 수정[판매자] ·POST /gds/app/m_editgoodssellgds_m_editgoodsskuprice— 상품 규격 재고 가격 수정[판매자] ·POST /gds/app/m_editgoodsskupricegds_m_editgoodsstock— 상품 재고 수정[판매자] ·POST /gds/app/m_editgoodsstockgds_m_goodsclassattributealllist— 상품 카테고리 속성 목록 조회[판매자] ·GET /gds/app/m_goodsclassattributealllistgds_m_goodsclasslist— 상품 카테고리 목록 조회[판매자] ·GET /gds/app/m_goodsclasslistgds_m_goodsclassspecalllist— 상품 카테고리 규격 목록 조회[판매자] ·GET /gds/app/m_goodsclassspecalllistgds_m_goodseditinfo— 상품 편집 상세 정보 조회[판매자] ·GET /gds/app/m_goodseditinfogds_m_goodseditskuinfo— 상품 규격 정보 조회[판매자] ·GET /gds/app/m_goodseditskuinfogds_m_goodsmakeaddresslist— 원산지 목록 조회[판매자] ·GET /gds/app/m_goodsmakeaddresslistgds_m_goodsskuiscandel— 상품 SKU 삭제 가능 여부 조회[판매자] ·GET /gds/app/m_goodsskuiscandelgds_m_storegoodslist— 판매자 상품 목록 조회 ·GET /gds/app/m_storegoodslistgds_u_addgoods— 상품 정보 추가[셀프 추가 결제] ·POST /gds/app/u_addgoodsgds_u_categorygoodslist— 상품 카테고리별 상품 목록 조회[사용자] ·GET /gds/app/u_categorygoodslistgds_u_complaintgoodsprice— 상품 가격 신고[사용자] ·POST /gds/app/u_complaintgoodspricegds_u_dategoodslist— 일자별 신상품 목록 조회[사용자] ·GET /gds/app/u_dategoodslistgds_u_datelist— 일자별 신상품 날짜 목록 조회[사용자] ·GET /gds/app/u_datelistgds_u_delgoods— 상품 정보 삭제[사용자] ·POST /gds/app/u_delgoodsgds_u_goods— 상품 상세 조회[사용자] ·GET /gds/app/u_goodsgds_u_goodsclasslist— 상품 카테고리 목록 조회[사용자] ·GET /gds/app/u_goodsclasslistgds_u_goodsclassspecalllist— 상품 카테고리 규격 목록 조회[사용자] ·GET /gds/app/u_goodsclassspecalllistgds_u_goodsskulist— 상품 규격 정보 조회[사용자] ·GET /gds/app/u_goodsskulistgds_u_imgsearchgoodslist— 이미지 상품 검색 목록[사용자] ·POST /gds/app/u_imgsearchgoodslistgds_u_recommendgoodslist— 상품 목록·범용[사용자] ·GET /gds/app/u_recommendgoodslistgds_u_searchgoodslist— 상품 검색 목록 조회[사용자] ·GET /gds/app/u_searchgoodslistgds_u_selfgoodslist— 셀프 추가 결제 상품 목록 ·GET /gds/app/u_selfgoodslistgds_u_similargoodslist— 유사 상품 목록 조회[사용자] ·GET /gds/app/u_similargoodslistgds_u_storegoodslist— 매장 상품 목록 조회[사용자] ·GET /gds/app/u_storegoodslist
사용법
- 필요한 엔드포인트 문서를 확인 (파일명 = 엔드포인트 이름)
ids_*_login_*중 하나로access_token획득 (APM_USER_TOKEN 환경변수에 저장)- 요청 헤더에
authcode: "HH " + $APM_USER_TOKEN추가 - 해당 문서의 서명 규칙에 따라
sign계산 후 호출
Usage Guidance
This skill is an instruction-only API reference for an APM product-management back end and requires you to supply an access token in the APM_USER_TOKEN environment variable. Before installing or using it: (1) verify you trust the Base URL (https://44k2t5n59e.execute-api.ap-northeast-2.amazonaws.com) and the package homepage; (2) avoid placing long-lived or highly privileged credentials in a global environment variable — use a scoped/ephemeral token if possible; (3) confirm whether you need separate seller and user tokens (the docs mention both roles but only one env var is declared); (4) watch for the documented inconsistencies (e.g., gds_m_delgoods shows POST in the flow but lists GET in Quick Reference) and test calls with a non-production account first; and (5) consider limiting the token's permissions to the minimum needed (read-only for discovery, separate write token for changes) and monitoring activity on that token.
Capability Assessment
Purpose & Capability
The name/description (APM 상품 관리 API) matches the documented endpoints: read/write product operations against a single API gateway. Requested items (just APM_USER_TOKEN) are plausible for an HTTP API client. One small mismatch: the docs reference separate login flows (ids_*_login for seller/user tokens) but the skill declares only a single primary environment variable (APM_USER_TOKEN) — it is unclear how seller vs user tokens should be managed.
Instruction Scope
Instructions tell the agent to call the external Base URL with an authcode header and to compute MD5-based signatures per-endpoint. That is expected for an API doc skill. Concerns: (1) the SKILL docs refer to performing 'ids_*_login' to acquire tokens but the login endpoints are not included in the package — the skill therefore expects a pre-provisioned token in the environment, which must be provided externally; (2) at least one endpoint file (gds_m_delgoods) contains an inconsistency: text describes a POST body but the Quick Reference lists Method: GET — this ambiguity could cause incorrect calls; (3) headers and signature scheme require constructing and transmitting the token ('HH ' + token) to an external host — nothing in the instructions attempts to read unrelated local files, but the agent will transmit whatever token is in APM_USER_TOKEN to the documented host.
Install Mechanism
No install spec and no code files — instruction-only skill. This is low-risk in terms of installation because nothing is written to disk or downloaded.
Credentials
Only one environment variable (APM_USER_TOKEN) is requested, which is proportionate for an API client. However, the APIs include both seller (관리자) and user endpoints; the docs imply different login flows/roles but do not declare separate env vars for seller vs user tokens. That ambiguity increases the chance of accidentally providing a token with broader privileges than intended.
Persistence & Privilege
The skill is not always-enabled and does not request system config paths or other privileges. It does not modify other skills' configurations. Autonomous invocation is allowed (default) but not flagged by itself.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install apmzoom-gds - After installation, invoke the skill by name or use
/apmzoom-gds - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: 33 goods management endpoints (merchant+user) for APM platform
Metadata
Frequently Asked Questions
What is APM 상품 관리 API?
APM 플랫폼의 상품 관리 API 모음. 관리자용 상품 추가/삭제/수정/가격·재고·할인 관리 17개 + 사용자용 상품 조회/검색/카테고리/추천/유사 상품/이미지 검색 16개, 총 33개 엔드포인트. 모든 엔드포인트는 먼저 ids_*_login으로 access_token 획득 후 a... It is an AI Agent Skill for Claude Code / OpenClaw, with 78 downloads so far.
How do I install APM 상품 관리 API?
Run "/install apmzoom-gds" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is APM 상품 관리 API free?
Yes, APM 상품 관리 API is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does APM 상품 관리 API support?
APM 상품 관리 API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created APM 상품 관리 API?
It is built and maintained by apmzoom (@apmzoom); the current version is v1.0.0.
More Skills