crewAIInc / crewAIInc/crewAI

Add BuyWhere as a community / commerce integration for CrewAI

Open
#6,290 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
58.8k
Forks
8.5k
Avg merge
1d 15h
Merged PRs (30d)
109

Description

Summary

We maintain an MCP-native commerce API (the BuyWhere MCP server) that exposes 7 production tools covering product search, price comparison, and deal discovery across 11M+ SKUs in Singapore, Southeast Asia, and the US. We are requesting that BuyWhere be listed in the CrewAI community / tools index as a supported commerce / shopping integration, and that the price-comparison example be considered for the CrewAI examples collection.

This is a listing + worked-example request, not a request to merge code into crewAIInc/crewAI. We are happy to maintain any new integration package ourselves.


What is BuyWhere?

BuyWhere is a unified commerce search API + MCP server for AI agents. Coverage: 11M+ products across Singapore, SE Asia, and the US (Shopee, Lazada, Amazon, Walmart, Best Buy, FairPrice, Cold Storage, Harvey Norman, etc.).

Live endpoints (already in production):

  • MCP server: https://api.buywhere.ai/mcp (7 tools: search_products, find_best_price, get_product, get_deals, find_deals, browse_categories, get_category_products)
  • REST API: https://api.buywhere.ai/v1/...
  • Docs: https://docs.buywhere.ai
  • Dashboard: https://buywhere.ai
  • MCP server source: https://github.com/BuyWhere/buywhere-mcp
  • Python SDK: https://pypi.org/project/buywhere/ (with [langchain] extra for the LangChain BuyWhereTool class)
  • LangChain integration (already shipped): https://github.com/BuyWhere/buywhere-langchain

Auth: API key, free evaluation tier, no credit card required for the first 10k requests/month.
Latency: p50 < 200 ms, p95 < 500 ms on search_products.


What's missing for CrewAI specifically

We have a LangChain integration (BuyWhere/buywhere-langchain) and an MCP server, but no buywhere-crewai package yet. We are evaluating whether to ship one, and would like to gauge whether the CrewAI team would accept a community PR adding it to the tools / integrations index — or, if not, point us to the right listing path.

If the answer is "yes, ship a buywhere-crewai package and we'll list it", the plan is:

  • MIT-licensed buywhere-crewai on PyPI exposing all 7 MCP tools as BaseTool subclasses.
  • Worked example: a 2-agent "researcher → analyst" crew that goes from a natural-language shopping question to a ranked shortlist with merchant links.
  • 24h-response support channel at partners@buywhere.ai for triage.

If the answer is "no listing path, but a community PR for crewAIInc/crewAI-examples would be welcome", we are happy to file that PR instead.


Proposed buywhere-crewai shape (preview)

pip install buywhere-crewai
from buywhere_crewai import (
    SearchProductsTool,
    ComparePricesTool,
    GetDealsTool,
    FindDealsTool,
    GetProductTool,
    BrowseCategoriesTool,
    GetCategoryProductsTool,
)
# Plug into any existing crew via `tools=[...]`.

Why BuyWhere + CrewAI is a strong fit

  1. Real-time commerce data, not a wrapper. BuyWhere aggregates live listings and prices across 11M+ SKUs in SEA + US. Tools are useful out of the box for any shopping-oriented crew.
  2. MCP-backed. BuyWhere is one of the few live commerce MCP servers today. CrewAI users building MCP-native agents can consume the same tools without re-implementing the MCP transport.
  3. Maintained partner. The team commits to a 1-week security SLA and a 2-week feature SLA for the first 12 months.

Specific asks (in priority order)

  1. Confirmation that a community buywhere-crewai listing would be accepted in the CrewAI tools / integrations index. If yes, we will ship within ~2 weeks.
  2. Optional: a worked example in crewAIInc/crewAI-examples modeled on the price-comparison crew pattern.
  3. No core-code change requested. We are not asking for anything inside crewAIInc/crewAI itself; this is purely a listing + example pointer.

Contact

  • Email: partners@buywhere.ai
  • BuyWhere: https://buywhere.ai
  • Docs: https://docs.buywhere.ai
  • MCP endpoint: https://api.buywhere.ai/mcp
  • MCP source: https://github.com/BuyWhere/buywhere-mcp
  • Existing LangChain integration: https://github.com/BuyWhere/buywhere-langchain

Happy to adjust the listing copy, ship a PR if you have a CONTRIBUTING path, or open a separate Docs issue. Thanks for considering — we think BuyWhere + CrewAI unlocks a category of agents that today have to hand-roll commerce integration.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review the linked BuyWhere MCP source, Python SDK, LangChain integration, and the crewAIInc/crewAI-examples repository, especially its price-comparison crew pattern. This issue needs a maintainer decision on the accepted listing path before implementation can begin. Done means documenting the path and, if accepted, submitting the community listing or worked-example PR.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
content, documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
28/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.