search-parser 0.3.0__tar.gz → 0.4.1__tar.gz

{search_parser-0.3.0 → search_parser-0.4.1}/.github/workflows/codeql.yml

@@ -57,7 +57,7 @@ jobs:
         # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
     steps:
     - name: Checkout repository
-      uses: actions/checkout@v4
+      uses: actions/checkout@v6
 
     # Add any setup steps before running the `github/codeql-action/init` action.
     # This includes steps like installing compilers or runtimes (`actions/setup-node`

{search_parser-0.3.0 → search_parser-0.4.1}/.github/workflows/publish.yml

@@ -3,6 +3,7 @@ name: Publish to PyPI
 on:
   release:
     types: [published]
+  workflow_dispatch:
 
 jobs:
   deploy:

{search_parser-0.3.0 → search_parser-0.4.1}/.github/workflows/test.yml

@@ -41,7 +41,7 @@ jobs:
           token: ${{ secrets.CODECOV_TOKEN }}
 
       - name: Upload coverage HTML artifact
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         if: matrix.python-version == '3.11'
         with:
           name: coverage-report

{search_parser-0.3.0 → search_parser-0.4.1}/.gitignore

@@ -48,4 +48,5 @@ Thumbs.db
 
 # uv
 
-search_parser_prompt.md
+search_parser_prompt.md
+

{search_parser-0.3.0 → search_parser-0.4.1}/CHANGELOG.md

@@ -9,6 +9,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.4.1] - 2026-03-05
+
+### Added
+
+- **Google parser: Mobile HTML support** — organic results from mobile Google pages (using `div.xpd` / `egMi0` layout) are now parsed correctly. URLs are decoded from Google's `/url?q=...` redirect format to the actual destination. People Also Ask, People Also Search For, and AI Overview are also extracted from the mobile layout.
+- **Google parser: Shopping Ads** — new `shopping_ads` field on `SearchResults` containing product cards from Google Shopping units (mobile `wywECb`/`qvfQJe` layout). Each entry has `result_type="shopping_ad"` with `metadata["price"]` and `metadata["merchant"]`. Shopping ads are never included in the organic `results` list.
+- New `result_type` value `"shopping_ad"` added to the `SearchResult` model's Literal type.
+- Markdown formatter now renders a `## Shopping Ads` section when `shopping_ads` are present.
+- 14 new unit tests covering mobile organic results (count, positions, URL decoding, titles), mobile PAA, mobile PASF, mobile AI Overview, and shopping ads (count, titles, prices, merchants, isolation).
+
+---
+
+## [0.4.0] - 2026-03-05
+
+### Added
+
+- **Google parser: Jobs** — new `jobs` field on `SearchResults` containing job listings from the Google Jobs widget. Each entry has `result_type="job"` with `metadata["company"]` and `metadata["location"]` fields. Jobs are never included in the organic `results` list.
+- **Google parser: Discussions and forums** — new `discussions` field on `SearchResults` containing entries from the "Discussions and forums" widget. Each entry has `result_type="discussion"` with a `description` excerpt and `metadata["source"]` (platform, forum, comment count, and date).
+- New `result_type` values `"job"` and `"discussion"` added to the `SearchResult` model's Literal type.
+- Markdown formatter now renders `## Jobs` and `## Discussions and Forums` sections when those fields are present.
+- Unit tests for jobs and discussions parsing using the `supply-chain-director-jobs.html` fixture.
+
+---
+
 ## [0.3.0] - 2026-02-21
 
 ### Changed
@@ -16,6 +40,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Renamed all stale `search_engine_parser` references to `search_parser` across config, docs, and CI workflows.
 - Fixed `pyproject.toml`: CLI entry point, hatch build target, and mypy `files` path all now point to `src/search_parser`.
 - Synced `__version__.py` to match `pyproject.toml`.
+- Added author and publisher metadata (`linksc`, `hello@link.sc`) to `pyproject.toml`.
+- Updated package description with explicit search engine names and output formats for better discoverability.
 
 ---
 
@@ -82,6 +108,8 @@ sponsored = results.sponsored         # list[SearchResult]
 - CI/CD workflows for testing, linting, coverage, and publishing.
 - Pre-commit hooks for ruff and mypy.
 
-[Unreleased]: https://github.com/getlinksc/search-parser/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/getlinksc/search-parser/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/getlinksc/search-parser/compare/v0.3.0...v0.4.0
+[0.3.0]: https://github.com/getlinksc/search-parser/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/getlinksc/search-parser/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/getlinksc/search-parser/releases/tag/v0.1.0

{search_parser-0.3.0 → search_parser-0.4.1}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: search-parser
-Version: 0.3.0
+Version: 0.4.1
 Summary: Parse Google, Bing, and DuckDuckGo HTML search results into JSON, Markdown, or dict — with auto-detection
 Project-URL: Homepage, https://github.com/getlinksc/search-parser
 Project-URL: Documentation, https://getlinksc.github.io/search-parser
 Project-URL: Repository, https://github.com/getlinksc/search-parser
 Project-URL: Issues, https://github.com/getlinksc/search-parser/issues
 Project-URL: Changelog, https://github.com/getlinksc/search-parser/blob/main/CHANGELOG.md
-Author-email: Your Name <you@example.com>
+Author-email: linksc <hello@link.sc>
 License: Apache-2.0
 License-File: LICENSE
 Keywords: bing,duckduckgo,google,parser,scraping,search
@@ -53,7 +53,7 @@ Description-Content-Type: text/markdown
 
 **Parse Google, Bing, and DuckDuckGo HTML search results into JSON, Markdown, or Python dict — with automatic search engine detection.**
 
-`search-parser` takes raw HTML from Google, Bing, and DuckDuckGo and extracts every result type — organic results, featured snippets, AI Overviews, People Also Ask, sponsored ads, and more — into clean, typed Python objects. It auto-detects the search engine from the HTML, so you never have to specify which parser to use.
+`search-parser` takes raw HTML from Google, Bing, and DuckDuckGo — desktop or mobile — and extracts every result type — organic results, featured snippets, AI Overviews, People Also Ask, sponsored ads, shopping ads, and more — into clean, typed Python objects. It auto-detects the search engine from the HTML, so you never have to specify which parser to use.
 
 ---
 
@@ -120,6 +120,9 @@ pip install search-parser
 | What People Are Saying | `people_saying` | ✓ | — | — |
 | People Also Search For | `people_also_search` | ✓ | — | — |
 | Related Products & Services | `related_products` | ✓ | — | — |
+| Jobs | `jobs` | ✓ | — | — |
+| Discussions and forums | `discussions` | ✓ | — | — |
+| Shopping ads | `shopping_ads` | ✓ | — | — |
 
 ---
 
@@ -161,6 +164,19 @@ for ad in data["sponsored"]:
 for product in data["related_products"]:
     print(product["title"])
 
+# Jobs (title, metadata["company"], metadata["location"])
+for job in data["jobs"]:
+    print(job["title"], job["metadata"]["company"], job["metadata"]["location"])
+
+# Discussions (title, url, description, metadata["source"])
+for disc in data["discussions"]:
+    print(disc["title"], disc["url"])
+    print(disc["metadata"]["source"])
+
+# Shopping ads (title, metadata["price"], metadata["merchant"])
+for ad in data["shopping_ads"]:
+    print(ad["title"], ad["metadata"]["price"], ad["metadata"]["merchant"])
+
 # Metadata
 print(data["search_engine"])        # "google"
 print(data["query"])                # "python web scraping"
@@ -196,6 +212,9 @@ for q in results.people_also_ask:
 for post in results.people_saying:
     print(post.title, post.url)
 
+for ad in results.shopping_ads:
+    print(ad.title, ad.metadata["price"], ad.metadata["merchant"])
+
 # Convert to JSON or Markdown directly on the model
 json_str = results.to_json()
 json_str = results.to_json(indent=4)  # custom indent
@@ -244,6 +263,44 @@ md_str = results.to_markdown()
   "people_saying": [],
   "people_also_search": [],
   "related_products": [],
+  "jobs": [
+    {
+      "title": "Global Supply Chain Director",
+      "url": "https://www.google.com/search?q=%22Supply+Chain+Director&udm=8",
+      "description": null,
+      "position": 0,
+      "result_type": "job",
+      "metadata": {
+        "company": "InterSources, Inc.",
+        "location": "San Jose, CA  •  via Ladders"
+      }
+    }
+  ],
+  "discussions": [
+    {
+      "title": "Being considered for Director of Supply Chain",
+      "url": "https://www.reddit.com/r/supplychain/comments/1ib0c1a/being_considered_for_director_of_supply_chain/",
+      "description": "I work for a mid-sized company as a Procurement Manager...",
+      "position": 0,
+      "result_type": "discussion",
+      "metadata": {
+        "source": "Reddit · r/supplychain · 10+ comments · 1 year ago"
+      }
+    }
+  ],
+  "shopping_ads": [
+    {
+      "title": "ALCON - Precision7 , 12 Pack",
+      "url": "http://www.google.com/aclk?sa=L&ai=...",
+      "description": null,
+      "position": 0,
+      "result_type": "shopping_ad",
+      "metadata": {
+        "price": "$51.19",
+        "merchant": "Contacts Direct"
+      }
+    }
+  ],
   "detection_confidence": 0.95,
   "parsed_at": "2026-02-21T00:00:00Z",
   "metadata": {}
@@ -276,6 +333,34 @@ Web scraping is the process of extracting data from websites...
 Learn how to scrape websites with Python...
 
 **URL:** https://realpython.com/python-web-scraping/
+
+---
+
+## Jobs
+
+### Global Supply Chain Director
+
+**Company:** InterSources, Inc.
+**Location:** San Jose, CA  •  via Ladders
+**URL:** https://www.google.com/search?q=%22Supply+Chain+Director&udm=8
+
+---
+
+## Discussions and Forums
+
+### Being considered for Director of Supply Chain
+
+I work for a mid-sized company as a Procurement Manager...
+
+**URL:** https://www.reddit.com/r/supplychain/comments/1ib0c1a/being_considered_for_director_of_supply_chain/
+
+## Shopping Ads
+
+### ALCON - Precision7 , 12 Pack
+
+**Price:** $51.19
+**Merchant:** Contacts Direct
+**URL:** http://www.google.com/aclk?sa=L&ai=...
 ```
 
 ---

{search_parser-0.3.0 → search_parser-0.4.1}/README.md

@@ -10,7 +10,7 @@
 
 **Parse Google, Bing, and DuckDuckGo HTML search results into JSON, Markdown, or Python dict — with automatic search engine detection.**
 
-`search-parser` takes raw HTML from Google, Bing, and DuckDuckGo and extracts every result type — organic results, featured snippets, AI Overviews, People Also Ask, sponsored ads, and more — into clean, typed Python objects. It auto-detects the search engine from the HTML, so you never have to specify which parser to use.
+`search-parser` takes raw HTML from Google, Bing, and DuckDuckGo — desktop or mobile — and extracts every result type — organic results, featured snippets, AI Overviews, People Also Ask, sponsored ads, shopping ads, and more — into clean, typed Python objects. It auto-detects the search engine from the HTML, so you never have to specify which parser to use.
 
 ---
 
@@ -77,6 +77,9 @@ pip install search-parser
 | What People Are Saying | `people_saying` | ✓ | — | — |
 | People Also Search For | `people_also_search` | ✓ | — | — |
 | Related Products & Services | `related_products` | ✓ | — | — |
+| Jobs | `jobs` | ✓ | — | — |
+| Discussions and forums | `discussions` | ✓ | — | — |
+| Shopping ads | `shopping_ads` | ✓ | — | — |
 
 ---
 
@@ -118,6 +121,19 @@ for ad in data["sponsored"]:
 for product in data["related_products"]:
     print(product["title"])
 
+# Jobs (title, metadata["company"], metadata["location"])
+for job in data["jobs"]:
+    print(job["title"], job["metadata"]["company"], job["metadata"]["location"])
+
+# Discussions (title, url, description, metadata["source"])
+for disc in data["discussions"]:
+    print(disc["title"], disc["url"])
+    print(disc["metadata"]["source"])
+
+# Shopping ads (title, metadata["price"], metadata["merchant"])
+for ad in data["shopping_ads"]:
+    print(ad["title"], ad["metadata"]["price"], ad["metadata"]["merchant"])
+
 # Metadata
 print(data["search_engine"])        # "google"
 print(data["query"])                # "python web scraping"
@@ -153,6 +169,9 @@ for q in results.people_also_ask:
 for post in results.people_saying:
     print(post.title, post.url)
 
+for ad in results.shopping_ads:
+    print(ad.title, ad.metadata["price"], ad.metadata["merchant"])
+
 # Convert to JSON or Markdown directly on the model
 json_str = results.to_json()
 json_str = results.to_json(indent=4)  # custom indent
@@ -201,6 +220,44 @@ md_str = results.to_markdown()
   "people_saying": [],
   "people_also_search": [],
   "related_products": [],
+  "jobs": [
+    {
+      "title": "Global Supply Chain Director",
+      "url": "https://www.google.com/search?q=%22Supply+Chain+Director&udm=8",
+      "description": null,
+      "position": 0,
+      "result_type": "job",
+      "metadata": {
+        "company": "InterSources, Inc.",
+        "location": "San Jose, CA  •  via Ladders"
+      }
+    }
+  ],
+  "discussions": [
+    {
+      "title": "Being considered for Director of Supply Chain",
+      "url": "https://www.reddit.com/r/supplychain/comments/1ib0c1a/being_considered_for_director_of_supply_chain/",
+      "description": "I work for a mid-sized company as a Procurement Manager...",
+      "position": 0,
+      "result_type": "discussion",
+      "metadata": {
+        "source": "Reddit · r/supplychain · 10+ comments · 1 year ago"
+      }
+    }
+  ],
+  "shopping_ads": [
+    {
+      "title": "ALCON - Precision7 , 12 Pack",
+      "url": "http://www.google.com/aclk?sa=L&ai=...",
+      "description": null,
+      "position": 0,
+      "result_type": "shopping_ad",
+      "metadata": {
+        "price": "$51.19",
+        "merchant": "Contacts Direct"
+      }
+    }
+  ],
   "detection_confidence": 0.95,
   "parsed_at": "2026-02-21T00:00:00Z",
   "metadata": {}
@@ -233,6 +290,34 @@ Web scraping is the process of extracting data from websites...
 Learn how to scrape websites with Python...
 
 **URL:** https://realpython.com/python-web-scraping/
+
+---
+
+## Jobs
+
+### Global Supply Chain Director
+
+**Company:** InterSources, Inc.
+**Location:** San Jose, CA  •  via Ladders
+**URL:** https://www.google.com/search?q=%22Supply+Chain+Director&udm=8
+
+---
+
+## Discussions and Forums
+
+### Being considered for Director of Supply Chain
+
+I work for a mid-sized company as a Procurement Manager...
+
+**URL:** https://www.reddit.com/r/supplychain/comments/1ib0c1a/being_considered_for_director_of_supply_chain/
+
+## Shopping Ads
+
+### ALCON - Precision7 , 12 Pack
+
+**Price:** $51.19
+**Merchant:** Contacts Direct
+**URL:** http://www.google.com/aclk?sa=L&ai=...
 ```
 
 ---

{search_parser-0.3.0 → search_parser-0.4.1}/docs/examples/advanced_usage.md

@@ -87,6 +87,25 @@ for item in results.people_also_search:
 # Product / service suggestions
 for product in results.related_products:
     print(product.title, product.url)
+
+# Jobs — metadata includes company, location, salary, employment_type, benefits
+for job in results.jobs:
+    print(job.title)
+    print(f"  {job.metadata['company']} — {job.metadata['location']}")
+    if job.metadata.get("salary"):
+        print(f"  Salary: {job.metadata['salary']}")
+
+# Discussions and forums — metadata["source"] has platform + comment count + age
+for disc in results.discussions:
+    print(disc.title)
+    print(f"  {disc.url}")
+    print(f"  {disc.metadata['source']}")
+
+# Shopping ads — metadata["price"] and metadata["merchant"]
+for ad in results.shopping_ads:
+    print(ad.title)
+    print(f"  {ad.metadata['price']} from {ad.metadata['merchant']}")
+    print(f"  {ad.url}")
 ```
 
 ## Using to_json() and to_markdown()

{search_parser-0.3.0 → search_parser-0.4.1}/docs/examples/basic_usage.md

@@ -79,6 +79,29 @@ for item in data["people_also_search"]:
 # Related Products & Services (Google only)
 for product in data["related_products"]:
     print(product["title"])
+
+# Jobs (Google only)
+for job in data["jobs"]:
+    print(job["title"], "at", job["metadata"]["company"])
+    print("  Location:", job["metadata"]["location"])
+    if job["metadata"].get("salary"):
+        print("  Salary:", job["metadata"]["salary"])
+    if job["metadata"].get("employment_type"):
+        print("  Type:", job["metadata"]["employment_type"])
+
+# Discussions and forums (Google only)
+for disc in data["discussions"]:
+    print(disc["title"])
+    print("  URL:", disc["url"])
+    print("  Source:", disc["metadata"]["source"])
+    if disc["description"]:
+        print("  Excerpt:", disc["description"][:100])
+
+# Shopping ads (Google only)
+for ad in data["shopping_ads"]:
+    print(ad["title"])
+    print("  Price:", ad["metadata"]["price"])
+    print("  Merchant:", ad["metadata"]["merchant"])
 ```
 
 ## Specifying the Engine

{search_parser-0.3.0 → search_parser-0.4.1}/docs/getting_started.md

@@ -81,6 +81,30 @@ for ad in data["sponsored"]:
 for product in data["related_products"]:
     print("Product:", product["title"])
 
+# Jobs (list) — Google only
+# Each job has metadata: company, location, salary (optional), employment_type, benefits
+for job in data["jobs"]:
+    print("Job:", job["title"])
+    print("  Company:", job["metadata"]["company"])
+    print("  Location:", job["metadata"]["location"])
+    print("  Salary:", job["metadata"].get("salary"))          # None if not listed
+    print("  Type:", job["metadata"].get("employment_type"))
+    print("  Benefits:", job["metadata"].get("benefits", []))
+
+# Discussions and forums (list) — Google only
+# Each entry has a url, description excerpt, and metadata["source"]
+for disc in data["discussions"]:
+    print("Discussion:", disc["title"])
+    print("  URL:", disc["url"])
+    print("  Source:", disc["metadata"]["source"])
+
+# Shopping ads (list) — Google only
+# Each entry has metadata["price"] and metadata["merchant"]
+for ad in data["shopping_ads"]:
+    print("Ad:", ad["title"])
+    print("  Price:", ad["metadata"]["price"])
+    print("  Merchant:", ad["metadata"]["merchant"])
+
 # Metadata
 print(data["query"])           # "python web scraping"
 print(data["total_results"])   # 26200000 or None
@@ -112,6 +136,15 @@ if results.ai_overview:
 for q in results.people_also_ask:
     print(q.title)
 
+for job in results.jobs:
+    print(job.title, job.metadata["company"], job.metadata.get("salary"))
+
+for disc in results.discussions:
+    print(disc.title, disc.url)
+
+for ad in results.shopping_ads:
+    print(ad.title, ad.metadata["price"], ad.metadata["merchant"])
+
 # Serialize without going through SearchParser
 json_str = results.to_json()  # JSON string, indent=2 by default
 json_str = results.to_json(indent=4)  # custom indent

{search_parser-0.3.0 → search_parser-0.4.1}/docs/index.md

@@ -4,8 +4,8 @@ Parse search engine HTML results into structured data (JSON, Markdown) with auto
 
 ## Features
 
-- **Auto-detection** of Google, Bing, and DuckDuckGo HTML
-- **Dedicated fields** for every result type — organic results, featured snippets, AI Overviews, People Also Ask, sponsored ads, and more
+- **Auto-detection** of Google, Bing, and DuckDuckGo HTML — desktop and mobile layouts
+- **Dedicated fields** for every result type — organic results, featured snippets, AI Overviews, People Also Ask, sponsored ads, shopping ads, and more
 - **Multiple output formats**: JSON, Markdown, Python dict
 - **Convenience methods**: `results.to_json()` and `results.to_markdown()` directly on the model
 - **Extensible** plugin architecture for adding new search engines
@@ -40,6 +40,10 @@ if data["ai_overview"]:
 
 for q in data["people_also_ask"]:
     print(q["title"])
+
+# Shopping ads (Google only)
+for ad in data["shopping_ads"]:
+    print(ad["title"], ad["metadata"]["price"], ad["metadata"]["merchant"])
 ```
 
 Or work directly with the typed model and use `to_json()` / `to_markdown()`:
@@ -69,3 +73,6 @@ md_str = results.to_markdown()
 | What People Are Saying | `people_saying` | ✓ | — | — |
 | People Also Search For | `people_also_search` | ✓ | — | — |
 | Related Products & Services | `related_products` | ✓ | — | — |
+| Jobs | `jobs` | ✓ | — | — |
+| Discussions and forums | `discussions` | ✓ | — | — |
+| Shopping ads | `shopping_ads` | ✓ | — | — |

{search_parser-0.3.0 → search_parser-0.4.1}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "hatchling.build"
 
 [project]
 name = "search-parser"
-version = "0.3.0"
+version = "0.4.1"
 description = "Parse Google, Bing, and DuckDuckGo HTML search results into JSON, Markdown, or dict — with auto-detection"
 readme = "README.md"
 requires-python = ">=3.10"
 license = {text = "Apache-2.0"}
 authors = [
-    {name = "Your Name", email = "you@example.com"}
+    {name = "linksc", email = "hello@link.sc"}
 ]
 keywords = ["search", "parser", "scraping", "google", "bing", "duckduckgo"]
 classifiers = [

{search_parser-0.3.0 → search_parser-0.4.1}/src/search_parser/__version__.py

@@ -1,3 +1,3 @@
 """Version information."""
 
-__version__ = "0.3.0"
+__version__ = "0.4.1"

{search_parser-0.3.0 → search_parser-0.4.1}/src/search_parser/core/models.py

@@ -27,6 +27,9 @@ class SearchResult(BaseModel):
         "people_saying",
         "people_also_search",
         "related_products",
+        "job",
+        "discussion",
+        "shopping_ad",
     ] = "organic"
     metadata: dict[str, object] = Field(default_factory=dict)
 
@@ -53,6 +56,9 @@ class SearchResults(BaseModel):
     people_saying: list[SearchResult] = Field(default_factory=list)
     people_also_search: list[SearchResult] = Field(default_factory=list)
     related_products: list[SearchResult] = Field(default_factory=list)
+    jobs: list[SearchResult] = Field(default_factory=list)
+    discussions: list[SearchResult] = Field(default_factory=list)
+    shopping_ads: list[SearchResult] = Field(default_factory=list)
 
     detection_confidence: float = Field(ge=0.0, le=1.0)
     parsed_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))

{search_parser-0.3.0 → search_parser-0.4.1}/src/search_parser/formatters/markdown_formatter.py

@@ -70,6 +70,24 @@ class MarkdownFormatter(BaseFormatter):
             for result in news:
                 lines.extend(self._format_result(result))
 
+        if results.jobs:
+            lines.append("## Jobs")
+            lines.append("")
+            for result in results.jobs:
+                lines.extend(self._format_job(result))
+
+        if results.discussions:
+            lines.append("## Discussions and Forums")
+            lines.append("")
+            for result in results.discussions:
+                lines.extend(self._format_result(result))
+
+        if results.shopping_ads:
+            lines.append("## Shopping Ads")
+            lines.append("")
+            for result in results.shopping_ads:
+                lines.extend(self._format_shopping_ad(result))
+
         lines.append("---")
         lines.append("")
         lines.append(f"*Parsed with search-engine-parser v{__version__}*")
@@ -102,6 +120,38 @@ class MarkdownFormatter(BaseFormatter):
         lines.append("")
         return lines
 
+    def _format_job(self, result: SearchResult) -> list[str]:
+        """Format a job listing result."""
+        lines: list[str] = []
+        lines.append(f"### {result.title}")
+        lines.append("")
+        if result.metadata.get("company"):
+            lines.append(f"**Company:** {result.metadata['company']}")
+        if result.metadata.get("location"):
+            lines.append(f"**Location:** {result.metadata['location']}")
+        if result.metadata.get("salary"):
+            lines.append(f"**Salary:** {result.metadata['salary']}")
+        if result.metadata.get("employment_type"):
+            lines.append(f"**Type:** {result.metadata['employment_type']}")
+        if result.url:
+            lines.append(f"**URL:** {result.url}")
+        lines.append("")
+        return lines
+
+    def _format_shopping_ad(self, result: SearchResult) -> list[str]:
+        """Format a shopping ad card."""
+        lines: list[str] = []
+        lines.append(f"### {result.title}")
+        lines.append("")
+        if result.metadata.get("price"):
+            lines.append(f"**Price:** {result.metadata['price']}")
+        if result.metadata.get("merchant"):
+            lines.append(f"**Merchant:** {result.metadata['merchant']}")
+        if result.url:
+            lines.append(f"**URL:** {result.url}")
+        lines.append("")
+        return lines
+
     def _format_result(self, result: SearchResult) -> list[str]:
         """Format a generic result."""
         lines: list[str] = []