Vaper.club

السجل الرسمي البحث والويب

Read-only vape industry data: posts, brands, shops, product search, comparison and reviews.

ماذا يمكنك أن تفعل مع Vaper.club؟

  • Reading the latest vape industry posts and searching articles.
  • Searching brands and shops, and reading their profiles.
  • Searching products and comparing prices and stock of the same model across retailers.
  • Summarizing product ratings and the newest user reviews.
  • Building applications that consume structured vaping industry data.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http vaper-club 'https://api.vaper.club/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "vaper-club": {
            "type": "http",
            "url": "https://api.vaper.club/mcp"
        }
    }
}
NPM package vaper-club-mcp
Claude Code
claude mcp add vaper-club -e 'VAPER_CLUB_API_BASE_URL=https://api.vaper.club/public-api/v1/' -e 'VAPER_CLUB_API_TIMEOUT=15' -e 'VAPER_CLUB_API_KEY=<your vaper_club_api_key>' -- npx -y vaper-club-mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "vaper-club": {
            "command": "npx",
            "args": [
                "-y",
                "vaper-club-mcp@1.0.1"
            ],
            "env": {
                "VAPER_CLUB_API_BASE_URL": "https://api.vaper.club/public-api/v1/",
                "VAPER_CLUB_API_TIMEOUT": "15",
                "VAPER_CLUB_API_KEY": "<your vaper_club_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • VAPER_CLUB_API_BASE_URL Vaper.club Public API base URL.
  • VAPER_CLUB_API_TIMEOUT API request timeout in seconds (0-300).
  • VAPER_CLUB_API_KEY سري Optional bearer token for the Vaper.club Public API.
PYPI package vaper-club-mcp
Claude Code
claude mcp add vaper-club -e 'VAPER_CLUB_API_BASE_URL=https://api.vaper.club/public-api/v1/' -e 'VAPER_CLUB_API_TIMEOUT=15' -e 'VAPER_CLUB_API_KEY=<your vaper_club_api_key>' -- uvx vaper-club-mcp==1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "vaper-club": {
            "command": "uvx",
            "args": [
                "vaper-club-mcp==1.0.1"
            ],
            "env": {
                "VAPER_CLUB_API_BASE_URL": "https://api.vaper.club/public-api/v1/",
                "VAPER_CLUB_API_TIMEOUT": "15",
                "VAPER_CLUB_API_KEY": "<your vaper_club_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • VAPER_CLUB_API_BASE_URL Vaper.club Public API base URL.
  • VAPER_CLUB_API_TIMEOUT API request timeout in seconds (0-300).
  • VAPER_CLUB_API_KEY سري Optional bearer token for the Vaper.club Public API.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Vaper Club Agent
  2. What is Vaper Club?
  3. Integration Options
  4. Available Skills
  5. Getting Started
  6. Use Cases
  7. Documentation
  8. Contributing
  9. License

Vaper Club Agent

Official AI Agent integration resources for Vaper Club, providing MCP connectivity, Agent Skills, and public API documentation for vape product, brand, model, and store data.

Vaper Club provides structured product catalog information to help AI agents and developers discover, search, and understand vaping products and related brands.

What is Vaper Club?

Vaper Club is a product discovery and information platform focused on the global vaping industry.

It provides structured information about:

  • Products – Product names, descriptions, specifications, categories, and images.
  • Brands – Brand profiles, official websites, and product portfolios.
  • Models – Normalized product model information and identification.
  • Listings – Product listings from different online vape retailers.
  • Stores – Retailer information and product availability.
  • Market Data – Product pricing and other available catalog information.

Integration Options

1. MCP Server

Connect AI agents and MCP-compatible applications directly to Vaper Club.

PropertyValue
ServiceVaper Club MCP
Endpointhttps://api.vaper.club/mcp
ProtocolModel Context Protocol (MCP)
TransportStreamable HTTP
AuthenticationNone (rate limited per IP)
DocumentationMCP Documentation · mcp/README.md

The server exposes read-only tools: get_latest_posts, search_posts, search_brands, get_brand_details, search_shops, get_shop_details, search_products, compare_products and get_product_reviews, plus reference resources under vaper://site/*.

A local STDIO adapter is also available as the npm package vaper-club-mcp (npx -y vaper-club-mcp); see mcp-server/README.md.

2. Public API

Developers can integrate Vaper Club data into their own applications using the public API.

PropertyValue
API Base URLhttps://api.vaper.club/public-api/v1
DocumentationPublic API Documentation · docs/api.md
FormatJSON
ProtocolHTTPS
AuthenticationNone (rate limited per IP)

Refer to the API documentation for endpoints, parameters, response schemas and error codes.

3. Agent Skills

This repository provides reusable Agent Skills to help AI agents understand Vaper Club's data structure and use its services correctly.

Skills are designed to work with compatible AI agent environments and can be extended independently. They are also published for discovery at https://vaper.club/.well-known/agent-skills/index.json.

Available Skills

SkillDescription
vaper-club-discoverySearch posts (news, reviews, guides), brands and retail shops.
vaper-club-product-researchFind and identify products, see prices and stock across shops, compare offers of the same model.
vaper-club-brand-researchBuild a brand profile: background, website, company, aliases, categories and models.
vaper-club-product-reviewsSummarize user reviews, ratings, and common praise and complaints of a product.

See skills/index.json and the skills/ directory for individual skill instructions.

Getting Started

Connect through MCP

Add the following MCP server configuration to an MCP-compatible client:

{
  "mcpServers": {
    "vaper-club": {
      "url": "https://api.vaper.club/mcp"
    }
  }
}

No authentication is required.

Use Agent Skills

Clone this repository:

git clone https://github.com/VaperClub/vaper-club-agent.git

Copy the required directories from skills/ (for example skills/vaper-club-product-research) into the skill directory supported by your AI agent. The skills call the MCP server above, so connect it first.

Use the Public API
curl "https://api.vaper.club/public-api/v1/products/search?q=disposable&pageSize=5"

See docs/api.md for all endpoints.

Use Cases

Vaper Club integrations can help developers and AI agents with:

  • Reading the latest vape industry posts and searching articles.
  • Searching brands and shops, and reading their profiles.
  • Searching products and comparing prices and stock of the same model across retailers.
  • Summarizing product ratings and the newest user reviews.
  • Building applications that consume structured vaping industry data.

Actual capabilities and data availability depend on the API and MCP tools currently exposed by Vaper Club. Vaper Club is intended for adults only and provides no guidance on circumventing age verification or legal restrictions.

Documentation

Contributing

Contributions, suggestions, and improvements are welcome.

You can contribute by:

  • Improving Agent Skills and documentation.
  • Adding integration examples.
  • Reporting incorrect instructions or technical issues.
  • Suggesting additional AI agent use cases.

Please open an issue or submit a pull request.

License

The source files, code examples, and original Agent Skills in this repository are licensed under the MIT License.

This license does not grant rights to Vaper Club trademarks, third-party trademarks, product images, or data accessed through Vaper Club services.

Use of Vaper Club APIs and data is subject to the applicable Vaper Club terms and policies.


Vaper Club
Website: https://vaper.club

الأسئلة الشائعة

ما هو Vaper.club؟

Read-only vape industry data: posts, brands, shops, product search, comparison and reviews.

كيف أثبّت Vaper.club؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http vaper-club 'https://api.vaper.club/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Vaper.club إلى مفتاح API؟

نعم. يتطلب VAPER_CLUB_API_KEY، وتضبطها في إعداداته.

هل Vaper.club مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Vaper.club؟

ينشره VaperClub. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.