What E-Commerce and Marketplace Skills Are Included in K-Skill?

The NomaDamas/k-skill repository provides six production-ready e-commerce and marketplace skills—Market-Kurly Search, Naver Shopping Search, Olive Young Search, Ohou Today Deal, Daangn Used-Goods Search, and Bunjang Search—that expose Korean retail platforms through YAML-described CLI commands returning structured JSON product data.

The k-skill monorepo organizes automation capabilities into modular, self-contained units. Each e-commerce and marketplace skill follows a standardized architecture using YAML descriptors and native implementations to query popular Korean retail APIs or perform lightweight HTML scraping, all without requiring user credentials or API keys.

Available E-Commerce and Marketplace Skills

The repository categorizes retail capabilities into retail (e-commerce) and marketplace (C2C used goods) domains. Each skill resides in a dedicated top-level directory with a consistent file structure.

Retail E-Commerce Skills

Market-Kurly Search queries the Kurly fresh grocery catalog. The skill descriptor lives in [market-kurly-search/SKILL.md](https://github.com/NomaDamas/k-skill/blob/main/market-kurly-search/SKILL.md), while the Node.js implementation resides at [packages/market-kurly-search/src/index.js](https://github.com/NomaDamas/k-skill/blob/main/packages/market-kurly-search/src/index.js). Unit tests are available in [packages/market-kurly-search/test/index.test.js](https://github.com/NomaDamas/k-skill/blob/main/packages/market-kurly-search/test/index.test.js).

Naver Shopping Search integrates with Naver's retail search engine. Configuration is defined in [naver-shopping-search/SKILL.md](https://github.com/NomaDamas/k-skill/blob/main/naver-shopping-search/SKILL.md) and the implementation logic is documented in [naver-shopping-search/instruction.md](https://github.com/NomaDamas/k-skill/blob/main/naver-shopping-search/instruction.md).

Olive Young Search targets the Olive Young beauty and health retailer. The skill uses [olive-young-search/SKILL.md](https://github.com/NomaDamas/k-skill/blob/main/olive-young-search/SKILL.md) for its descriptor and [olive-young-search/instruction.md](https://github.com/NomaDamas/k-skill/blob/main/olive-young-search/instruction.md) for implementation details.

Ohou Today Deal retrieves daily deals from the Ohou (Ohouse) interior shopping platform. Its metadata is stored in [ohou-today-deal/SKILL.md](https://github.com/NomaDamas/k-skill/blob/main/ohou-today-deal/SKILL.md) with logic in [ohou-today-deal/instruction.md](https://github.com/NomaDamas/k-skill/blob/main/ohou-today-deal/instruction.md).

Marketplace (C2C) Skills

Daangn Used-Goods Search searches the Daangn neighborhood marketplace for secondhand items. The skill structure includes [daangn-used-goods-search/SKILL.md](https://github.com/NomaDamas/k-skill/blob/main/daangn-used-goods-search/SKILL.md) and [daangn-used-goods-search/instruction.md](https://github.com/NomaDamas/k-skill/blob/main/daangn-used-goods-search/instruction.md).

Bunjang Search queries the Bunjang second-hand goods platform. It follows the same pattern with [bunjang-search/SKILL.md](https://github.com/NomaDamas/k-skill/blob/main/bunjang-search/SKILL.md) and [bunjang-search/instruction.md](https://github.com/NomaDamas/k-skill/blob/main/bunjang-search/instruction.md).

How E-Commerce Skills Work

Every skill follows a four-stage execution pattern defined in its YAML descriptor.

Input: The CLI accepts parameters such as search keywords, product IDs, region filters, or pagination tokens.

Processing: The implementation calls public REST endpoints (e.g., Kurly, Naver Shopping, Daangn) or performs lightweight HTML scraping directly from the user's machine. No credential-required proxy is used, as these skills bypass the k-skill-proxy layer entirely.

Output: Each skill returns a JSON payload containing a list of items with standardized fields—title, price, URL, thumbnail—plus pagination metadata.

Safety: Skills tagged with retail or marketplace trigger the runtime's "no-price-advice" guardrail, ensuring responses are never presented as financial or transactional advice.

Running E-Commerce and Marketplace Skills

The k-skill-cli framework automatically generates executable shims for each skill. You can invoke any e-commerce or marketplace skill using npx without global installation.

Search Kurly's grocery catalog:

npx -y @nomadamas/k-skill@0 market-kurly-search \
  --keyword "organic milk" \
  --limit 5

Query Daangn's used-goods marketplace:

npx -y @nomadamas/k-skill@0 daangn-used-goods-search \
  --keyword "vintage camera" \
  --region "Seoul"

Retrieve results from Bunjang:

npx -y @nomadamas/k-skill@0 bunjang-search \
  --keyword "desk lamp" \
  --page 1

Query Naver Shopping with price sorting:

npx -y @nomadamas/k-skill@0 naver-shopping-search \
  --query "wireless earbuds" \
  --sort "price_asc"

Each command outputs a formatted JSON array suitable for piping into downstream tools or direct display.

Skill Architecture and File Structure

The k-skill monorepo enforces a strict layout to ensure consistency across all e-commerce and marketplace capabilities.

Descriptor (SKILL.md): Declares the skill's name, category (retail or marketplace), inputs, outputs, and runtime profile.

Instruction File (instruction.md): Contains human-readable usage guides and links to the underlying implementation logic. For skills like market-kurly-search, this references the actual Node.js source code.

Implementation: Either Python scripts or Node.js packages (e.g., packages/market-kurly-search/src/index.js) that perform data retrieval.

Tests: Located under tests/ folders (e.g., packages/market-kurly-search/test/index.test.js), exercising the public API of the skill.

Summary

• Six skills cover major Korean e-commerce and marketplace platforms: Market-Kurly, Naver Shopping, Olive Young, Ohou, Daangn, and Bunjang.
• Zero API keys are required; skills query public endpoints or scrape HTML directly.
• Consistent structure: Each skill uses a SKILL.md descriptor, instruction.md guide, and dedicated implementation files.
• JSON output: All skills return structured product data including title, price, URL, and thumbnail.
• Safety guardrails: Retail and marketplace skills carry the "no-price-advice" tag to prevent misinterpretation as financial advice.

Frequently Asked Questions

Do k-skill e-commerce skills require API keys?

No. According to the repository source code, these skills call public REST endpoints or perform lightweight HTML scraping directly from the user's machine. They bypass the k-skill-proxy layer, which is only required for free APIs that need credential management.

What data format do k-skill marketplace skills return?

All skills return a JSON payload containing a list of matching items. Each entry includes standard fields such as title, price, URL, and thumbnail, along with pagination metadata for result set navigation.

How does k-skill handle price information safely?

Skills in the retail or marketplace categories are tagged with a "no-price-advice" guardrail. As implemented in the runtime, this ensures the response is never presented as financial or transactional advice, maintaining compliance with platform policies.

Can I run k-skill e-commerce queries without installing the CLI globally?

Yes. The k-skill-cli framework supports execution via npx -y @nomadamas/k-skill@0 <skill-name>, allowing you to run any e-commerce or marketplace skill without global installation or local configuration.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}