SuperAPI AI Directory

deal-discovery-research

Writing & research

View repository

Updated 10-15 20:29

About this skill

Deal discovery research

Access and contract

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the named Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact tool names, methods, and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound pages and calls by the requested scope and credit budget. Preserve source URLs, identifiers, and collection times.

Find posted offers and check the conditions that make them comparable. Slickdeals community posts are discovery evidence, not a merchant checkout quote.

Discover and inspect offers

  • Start with the product, exact model/variant, country, acceptable merchants, condition, budget, and any membership or coupon restrictions. Search a bounded result set, then fetch selected deals using a returned thread_id or deal URL. Although both fields are optional in the schema, supply one valid identifier.
  • Discover category slugs, primary categories, forum IDs, and deal types through their own routes. For advanced search, take brand/store/category facet IDs from that query's returned facets; never guess them or reuse unrelated IDs.
  • Keep simple category browse and primary-category browse separate. Use the endpoint reference for each route's pagination and filter names rather than assuming all Slickdeals surfaces share one search contract.
  • Read a bounded comment sample for coupon exclusions, regional restrictions, stock changes, shipping costs, and product-condition reports. Community votes and comments are attributed observations, not verified merchant guarantees.
scripts/crawlora.sh /slickdeals/categories
scripts/crawlora.sh /slickdeals/search q="wireless headphones"
scripts/crawlora.sh /slickdeals/search/advanced q="wireless headphones" page=1
# Use a returned deal URL, for example:
# scripts/crawlora.sh /slickdeals/deal url="$DEAL_URL"
# scripts/crawlora.sh /slickdeals/comments url="$DEAL_URL"

Normalize and report

Compare the same model, variant, pack quantity, condition, currency, and price basis. Separate upfront price from rebates, coupon codes, membership-only rates, subscriptions, trade-ins, and gift-card value. Keep shipping/tax or eligibility unknown when not returned. A claimed markdown or crossed-out list price does not prove an all-time low; a price-history claim requires comparable historical evidence. Posted time, expired flags, and comment reports are not current stock verification. Return a ranked shortlist by the user's criteria with merchant, conditions, source link, observation time, and unresolved checkout questions. A failed/empty search cannot prove no offers exist. Do not purchase or apply coupons to a user's account from a research request.

RetailMeNot merchant context

Discover RetailMeNot categories, stores, or autocomplete matches, then pass the returned merchant domain to store detail. Keep market=us and market=ca separate; Canadian domains must come from the Canadian store directory. Merchant coupon and cashback snapshots are conditional offers, not verified redemption. Keep codes, exclusions, expiry, minimum spend, membership, click-through tracking, and cashback timing separate from upfront price. Do not add cashback to a coupon saving without evidence that the offers stack. Deal events and blog posts give editorial context; they do not establish current availability.

scripts/crawlora.sh /retailmenot/categories
scripts/crawlora.sh /retailmenot/cashback
# Resolve a returned merchant domain before:
# scripts/crawlora.sh /retailmenot/store domain="$MERCHANT_DOMAIN" market=us