About

Imported from sickn33/agentic-awesome-skills (skills/buywhere-product-catalog/SKILL.md). Install upstream with npx skills add sickn33/agentic-awesome-skills --skill buywhere-product-catalog. Copyright stays with the author (Not declared).

BuyWhere Product Catalog

Name: buywhere-product-catalog
Author: sickn33

Overview

BuyWhere gives AI agents a product-catalog surface for shopping flows, price comparison, and deal discovery. Use this skill when you want an agent to connect product search or merchant-aware commerce actions through BuyWhere's MCP setup path or API onboarding flow.

The safest public starting points are the live developer portal, API key signup flow, MCP guide, and the official Cursor plugin repository.

When to Use This Skill

Use when you want to add structured product search to an AI shopping or recommendation agent.
Use when the user asks for BuyWhere MCP setup in Cursor, Claude Desktop, or a custom agent runtime.
Use when you need a concrete onboarding path for BuyWhere API keys, MCP configuration, or plugin discovery.

How It Works

Step 1: Choose the integration surface

Start from the public BuyWhere entry point that matches the user's setup:

Developer portal: https://buywhere.ai/developers/
API key signup: https://buywhere.ai/api-keys/
MCP integration guide: https://api.buywhere.ai/docs/guides/mcp
Cursor plugin repo: https://github.com/BuyWhere/buywhere-cursor-plugin

Step 2: Confirm the user's runtime

Ask which host the user is integrating with before giving setup instructions:

Cursor or another MCP-capable coding assistant
Claude Desktop
A custom MCP client
A direct REST API integration

Do not assume the same config file or launch command works across all hosts.

Step 3: Guide the first successful connection

Prefer a minimal first-run path:

Get a BuyWhere API key.
Follow the MCP or plugin setup path for the host runtime.
Run one simple product-search request before expanding to comparison or deal workflows.

Step 4: Expand into commerce workflows

Once the first query works, help the user branch into the next layer:

product search and discovery
price comparison across merchants
deal discovery flows
shopping-agent orchestration that routes users to merchant destinations

Examples

Example 1: Cursor plugin discovery

Use BuyWhere Product Catalog to help me connect BuyWhere inside Cursor and verify one product-search query.

Example 2: MCP onboarding

Use BuyWhere Product Catalog to set up BuyWhere MCP for my shopping agent and keep the first test minimal.

Best Practices

✅ Start from the live developer portal or API key flow before giving configuration details.
✅ Keep the first proof of integration to one successful query.
✅ Ask which MCP host or API runtime the user is using.
❌ Do not claim a specific product-count or retailer-count unless you have current runtime evidence.
❌ Do not send users to deprecated or broken documentation surfaces when a working public page exists.

Limitations

This skill does not replace environment-specific validation inside the target MCP host or API client.
Public BuyWhere surfaces can change, so re-check live URLs when precise setup details matter.

Security & Safety Notes

Treat API keys as secrets. Use placeholders in examples and never paste live credentials into chat, docs, or screenshots.
Confirm the user's target host before suggesting filesystem paths, launch commands, or local config edits.

Common Pitfalls

Problem: The user wants BuyWhere setup help but has not created an API key yet. Solution: Start at https://buywhere.ai/api-keys/ and only move to config after that step is complete.
Problem: A documentation hostname is unavailable. Solution: Prefer the live developer portal, API key flow, MCP guide on api.buywhere.ai, and the official GitHub plugin repo.

Related Skills

@api-design-principles - Use when the user needs API-shape guidance around a commerce integration.
@mcp-builder - Use when the user is building or extending an MCP server rather than consuming one.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/sickn33-agentic-awesome-skills-buywhere-product-catalog/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

sickn33-agentic-awesome-skills-buywhere-product-catalog.ocm.jsonjson

{
  "ocm": "1",
  "id": "sickn33-agentic-awesome-skills-buywhere-product-catalog",
  "kind": "skill",
  "name": "buywhere-product-catalog",
  "description": "Use BuyWhere's MCP and API surfaces to add product search, price comparison, and deal discovery to AI shopping agents.",
  "publisher": "sickn33",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "buywhere",
      "ecommerce",
      "shopping",
      "mcp",
      "api",
      "product-catalog",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Use BuyWhere's MCP and API surfaces to add product search, price comparison, and deal discovery to AI shopping agents."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/sickn33/agentic-awesome-skills",
      "path": "skills/buywhere-product-catalog/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/sickn33/agentic-awesome-skills/blob/HEAD/skills/buywhere-product-catalog/SKILL.md",
      "key": "sickn33/agentic-awesome-skills/skills/buywhere-product-catalog/SKILL.md"
    },
    "license": "Not declared"
  },
  "instructions": "# BuyWhere Product Catalog\n\n## Overview\n\nBuyWhere gives AI agents a product-catalog surface for shopping flows, price comparison, and deal discovery. Use this skill when you want an agent to connect product search or merchant-aware commerce actions through BuyWhere's MCP setup path or API onboarding flow.\n\nThe safest public starting points are the live developer portal, API key signup flow, MCP guide, and the official Cursor plugin repository.\n\n## When to Use This Skill\n\n- Use when you want to add structured product search to an AI shopping or recommendation agent.\n- Use when the user asks for",
  "cost": {
    "context_tokens": 977
  }
}

Fetch it by URL: GET /api/v1/registry/sickn33-agentic-awesome-skills-buywhere-product-catalog/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.