SuperAPI AI 工具集

deal-discovery-research

写作与研究

查看项目

更新于 10-15 20:29

技能介绍

用途:查找并比较 Slickdeals 与 RetailMeNot 上的优惠信息,用于优惠发现研究。

主要能力:通过 Crawlora 的 deal 搜索、分类、高级筛选(facets)、优惠详情和社区评论接口获取数据。可发现分类 slug、主分类、论坛 ID 和优惠类型;高级搜索的品牌/店铺/分类 facet ID 需取自该次查询返回的 facets,不可猜测或复用无关 ID。可读取有界评论样本,了解优惠券排除条款、地区限制、库存变化、运费和商品状况报告。

使用方式:设置 CRAWLORA_API_KEY 为 Crawlora 密钥。已连接时优先使用具名 Crawlora MCP 工具,否则使用随附的 scripts/crawlora.sh,它向 https://api.crawlora.net/api/v1 发送 x-api-key。具体工具名、方法和参数见 reference/endpoints.md。示例命令:scripts/crawlora.sh /slickdeals/categories;scripts/crawlora.sh /slickdeals/search q="wireless headphones";scripts/crawlora.sh /slickdeals/search/advanced q="wireless headphones" page=1;scripts/crawlora.sh /slickdeals/deal url="$DEAL_URL";scripts/crawlora.sh /slickdeals/comments url="$DEAL_URL";scripts/crawlora.sh /retailmenot/categories;scripts/crawlora.sh /retailmenot/cashback;scripts/crawlora.sh /retailmenot/store domain="$MERCHANT_DOMAIN" market=us。

适用场景:按产品、型号/变体、国家、可接受商家、成色、预算及会员/优惠券限制进行有界搜索,再按返回的 thread_id 或 deal URL 获取选定优惠,输出按用户标准排序的候选清单,含商家、条件、来源链接、观察时间和未解决的结账问题。

限制:Slickdeals 社区帖子是发现证据,非商家结账报价;社区投票和评论是带归属的观察,非商家保证。需检查应用代码及 HTTP 状态,数据在 data 内;认证错误即停止,429 退避,瞬时上游失败重试一次。按请求范围和信用预算限制页数与调用次数,保留来源 URL、标识符和采集时间。比较时须统一型号、变体、包装数量、成色、货币和价格基准,区分前期价格与返利、优惠券码、会员价、订阅、以旧换新和礼品卡价值。声称的降价或划线价不证明历史最低价;发布时间、过期标志和评论报告不构成当前库存验证。失败或空搜索不能证明不存在优惠。不得从研究请求中购买或向用户账户应用优惠券。RetailMeNot 的 market=us 与 market=ca 须分开,加拿大域名须来自加拿大店铺目录;商家优惠券和返现快照是条件性优惠,非已验证兑换,返现与优惠券叠加需有证据。