Skip to content

shopping Analyzer (Deal Pulse) #527

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
swarajio wants to merge 2 commits into
base: main
Choose a base branch
from
Open

shopping Analyzer (Deal Pulse) #527

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1889ed8
Add files via upload
swarajio Sep 12, 2026
157b644
Update README.md
swarajio Sep 12, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
166 changes: 23 additions & 143 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,160 +1,40 @@
<img width="1280" height="640" alt="Webcmd β€” stop paying agents to rediscover the web" src="docs/readme-hero-v2.png" />
πŸ›οΈ Deal Pulse
The Ultimate Shopping Analyzer

Built with ❀️ for the webcmd Hackathon

<p align="center">
<a href="https://www.npmjs.com/package/@agentrhq/webcmd">
<img alt="NPM version" src="https://img.shields.io/npm/v/@agentrhq/webcmd.svg?style=for-the-badge&color=1E88E5&labelColor=000000">
</a>
<a href="https://webcmd.dev/docs">
<img alt="Documentation" src="https://img.shields.io/badge/docs-webcmd.dev-7C3AED.svg?style=for-the-badge&labelColor=000000">
</a>
<a href="https://github.com/agentrhq/webcmd/blob/main/LICENSE">
<img alt="License" src="https://img.shields.io/badge/license-Apache%202.0-1E88E5.svg?style=for-the-badge&labelColor=000000">
</a>
<a href="https://discord.gg/9YP2C9tvMp">
<img alt="Join the community on Discord" src="https://img.shields.io/badge/Join%20the%20community-5865F2.svg?style=for-the-badge&logo=discord&logoColor=white&labelColor=000000&logoWidth=20">
</a>
<a href="https://x.com/agentrhq">
<img alt="Follow AgentR on X" src="https://img.shields.io/badge/Built%20by%20%40agentrhq-000000.svg?style=for-the-badge&logo=x&logoColor=white&labelColor=000000&logoWidth=20">
</a>
</p>
πŸ“– About The Project
In today's fast-paced e-commerce world, prices for the exact same product fluctuate wildly across different websites. Manually checking Amazon, Walmart, Best Buy, and other retailers to find the best deal is time-consuming and frustrating.

# Webcmd
Deal Pulse is a smart shopping analyzer that does the heavy lifting for you. Simply enter a product name, and Deal Pulse instantly scans the internet to provide you with a comprehensive price analysis. It finds the absolute lowest and highest prices available, calculates your exact savings, and gives you a direct link to make the purchase.

**Self-learning browser infra for AI agents.**
Stop overpaying and start shopping smarter with Deal Pulse!

Webcmd learns the navigational context of websites as agents use them, then
turns that knowledge into local memory for faster, cheaper, more reliable
browser automation. The goal is simple: stop making agents rediscover the same
sites on every run and cut browser-agent token spend by up to 90%.
✨ Key Features
πŸ” Global Price Scanning: Scours multiple e-commerce platforms across the internet to find the product you are looking for.

Webcmd pairs live browser control with a self-learning memory layer:
πŸ“‰ High/Low Price Detection: Instantly displays the highest and lowest prices currently available on the web.

| Layer | Scenario | What Webcmd Helps With |
| --- | --- | --- |
| 0. Live browser control | The site is unfamiliar. | Use `webcmd browser` to inspect, click, type, extract, capture network calls, and complete the task in a real browser. |
| 1. Sitemap memory | The site is familiar, but the action space is not fully known. | Capture an agent-facing sitemap of observed pages, states, actions, workflows, APIs, pitfalls, and fallback paths. |
πŸ’° Smart Savings Calculator: Automatically calculates and displays exactly how much money you save by choosing the best deal.

## Demo
πŸ›’ Direct Purchase Links: One-click routing to the retailer offering the lowest price so you can checkout immediately.

https://github.com/user-attachments/assets/bdb65307-9e2a-4d58-9175-45d59528ae37
πŸ“Š Multi-Retailer Comparison: Provides a clean, comparative list of prices from other top retailers offering the exact same product.

## Quick Start
πŸ’» How It Works
Search: The user enters the name or URL of a desired product into the Deal Pulse search bar.

### Agent prompt
Analyze: Our engine scrapes and aggregates real-time pricing data from various trusted e-commerce platforms.

```text
Fetch and follow https://raw.githubusercontent.com/agentrhq/webcmd/main/start.md to set up Webcmd end to end.
```
Compare: The algorithm sorts the data, identifying the price ceiling (highest) and floor (lowest).

### Manual
Deliver: The user is presented with a dashboard showing their potential savings, alternative retailer prices, and the winning link to buy the product.

Webcmd requires Node.js 20.6+.
πŸ› οΈ Tech Stack
(Update this section based on the actual technologies your team used!)

```bash
npm install -g @agentrhq/webcmd
webcmd skills add
```
Frontend: React.js / HTML5 / CSS3 / Tailwind CSS

When prompted, choose Claude, Codex, another supported harness, or a custom
skills path. That installs exactly one skill, `webcmd-browser`.
Backend: Node.js / Express / Python (Flask/Django)

Load or tag `webcmd-browser` only for live browser work, then describe the
outcome you want. Installation and setup commands do not require that skill.

```text
Use webcmd to research the latest discussions about browser automation across Hacker News and Reddit, then return a concise comparison with source links.
```

## What You Can Ask

- β€œUse webcmd to research agentic browser automation on PubMed and return the title, authors, publication date, abstract, and URL for each result.”
- β€œUse webcmd to find active AI infrastructure companies in the YC company directory and return the company, batch, description, location, profile URL, and source links. Keep it read-only.”
- β€œUse webcmd to look up parts on Grainger by part number and return price, stock, minimum order quantity, lead time, and product URL.”
- β€œUse webcmd with my logged-in `work` profile to summarize unread LinkedIn messages from the last seven days and return the sender, subject or opening text, received time, and conversation URL.”
- β€œUse webcmd to check Grainger part prices and SAP Ariba purchase-order status, then return a combined summary.”

## See It in Action

```text
Use webcmd with my logged-in `social` profile to collect my recent X bookmarks and return the author, text, and URL.
```

The agent uses the logged-in profile to complete the task in a real browser.
Along the way, Webcmd quietly retains useful navigation context so later agents
can avoid repeating the same exploration.

## Where Webcmd Works

Webcmd can work through authenticated browser sessions across research, social,
AI, shopping, and booking products.

| Group | Supported surfaces | Representative outcomes |
| --- | --- | --- |
| research and communities | Hacker News, Reddit, PubMed | Compare current discussions, find primary research, and return concise summaries with source links. |
| social and professional | X/Twitter, LinkedIn, TikTok | Collect bookmarks, monitor public posts, or research people and creators with a named profile when needed. |
| AI tools | ChatGPT, Claude, Gemini, NotebookLM | Retrieve conversations, research outputs, notebooks, and generated materials from the tools you already use. |
| shopping and bookings | Amazon, Blinkit, Zepto, BigBasket, District, Practo | Compare products, availability, prices, appointments, events, and delivery options. |

This list is illustrative. Webcmd can operate other websites through the same
live browser workflow.

## How Self-Learning Works

<img width="1672" height="941" alt="How Webcmd learns: load memory, use the live web, keep useful learnings, and help the next agent" src="docs/readme-self-learning.png" />

Learning stays quiet and selective: the live browser is always truth, Webcmd
never explores just to learn, and a memory failure never blocks the task. First
access may use a Webcmd Cloud seed; subsequent learning stays local.

For local, multi-step browser exploration, agents can send one sandboxed
Playwright-style program to an explicit browser session:

```bash
webcmd --profile work session create "Work Project" -f json
# id: work-project-k7
webcmd --profile work --session work-project-k7 browser tabs
webcmd --profile work --session work-project-k7 browser run --file explore.js
printf 'return await page.title();' \
| webcmd --profile work --session work-project-k7 browser run --stdin
webcmd --profile work session close work-project-k7
```

Profiles are cookie jars; Sessions are independent browser windows within a
profile, so Session IDs are immutable, Profile-scoped, and safe to reuse for
that Session's lifetime. Parallel agents should create separate Sessions.
Raw browser commands require an explicit readable Session ID.

## Benchmarks

On [BU Bench V1](https://github.com/browser-use/benchmark#bu-bench-v1), a
100-task browser automation benchmark, Webcmd recorded the highest accuracy and
lowest estimated controller cost per completed task, and fewest agent turns per
completed task in this comparison.

![BU Bench V1 comparison: webcmd leads accuracy at 67%, cost per completed task at $0.255, and agent turns per completed task at 9.8](./benchmarks/charts/bu-bench-readme.svg)

All tools used the same Pi controller, controller model, Codex `gpt-5.4` judge,
and CloakBrowser engine. This is a stronger judge than the original BU Bench
setup, whose [current runner uses Gemini 2.5 Flash](https://github.com/browser-use/benchmark/blob/main/run_eval.py#L37-L38).
Accuracy is passed tasks out of 100. Cost and agent turns are averaged over
completed tasks; cost excludes judge usage. See the
[benchmark report](./benchmarks/README.md) for category results, methodology,
architectural analysis, and reproduction steps.

## Learn More

Webcmd Cloud can run supported commands and browser sessions on hosted infrastructure. It is in active development and is not yet stable.

- [Prompt Cookbook](https://webcmd.dev/docs/agent-prompts)
- [How Webcmd Works](https://webcmd.dev/docs/concepts)
- [Local or Cloud](https://webcmd.dev/docs/local-or-cloud)
- [Command Surface](https://webcmd.dev/docs/cli-reference)

## Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md).

## License

Released under the terms in [`LICENSE`](./LICENSE).
Web Scraping / API: BeautifulSoup / Puppeteer / RapidAPI e-commerce endpoints
Empty file added analyzer.js
View file
Open in desktop
Empty file.
19 changes: 19 additions & 0 deletions debug.html
View file
Open in desktop

Large diffs are not rendered by default.

5 changes: 5 additions & 0 deletions gitignore.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
ο»Ώnode_modules/
package-lock.json
debug.html
.DS_Store
*.log
Loading