安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install business-complaint-pattern-analysis
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 business-complaint-pattern-analysis。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

商业投诉模式分析通过 Crawlora 帮助研究和比较公开的 Better Business Bureau (BBB) 投诉叙述、企业回应、状态及报告窗口总量。它支持实体核验、范围受限的数据收集和基于证据的报告，且不会将指控视为既定事实，也不会混淆不同的 BBB 指标。
作为 Openclaw Skills 中用于有来源依据的商业研究的技能，它强调可追溯性和谨慎解读：保留来源 ID、URL、日期和抓取时间；区分投诉叙述、回应线程中的角色及 BBB 状态；明确说明列表不完整、信息删节及分母限制。

应用场景

比较所选企业和地点之间的投诉主题或回应模式。
在保留各档案自身期间文本的同时，研究指定报告期或日期范围内的 BBB 档案。
将投诉叙述、回应线程和 BBB 标示的状态视为不同证据分别审查。
当汇总总数可用但逐条投诉列表不完整时，生成有来源依据的摘要。
审核覆盖范围、样本量、状态计数及评级原因，不将投诉数量表述为企业投诉率。
根据公开投诉数据得出结论前，识别尚待解答的问题和局限。

工作原理

确定研究范围：识别企业和地点，定义比较时间窗口，并选择可比的投诉类别。
使用 BBB 数据集筛选条件、搜索或实时搜索解析每个实体；核实企业 ID、名称、地点、网站及总部关系。
使用适当的实时投诉或更多信息路由，从已核实的档案或总部 URL 获取投诉详情；不要猜测投诉页面 URL。
检查 Crawlora 响应代码和负载，保留来源标识符及时间戳，并遵守请求、页面和额度限制。遇到身份验证错误时停止，HTTP 429 时退避等待，临时上游故障时重试一次。
按投诉 ID 对逐条记录去重，必要时在本地筛选返回日期，并标明覆盖范围受限，因为投诉路由没有日期筛选或分页参数。
分别分析叙述、回应角色、日期和 BBB 状态。保留删节内容，不要将答复视为已解决或承认责任的证明。
分别报告逐条样本和汇总总数，披露列表不完整情况及分母，并在列出剩余局限的同时引用简短且注明来源的摘录。

配置指南

获取 Crawlora API 密钥，并在该技能使用的环境中将其设为 CRAWLORA_API_KEY。
如果已连接 Crawlora MCP 工具，优先使用这些工具。否则，使用随附的 scripts/crawlora.sh 包装脚本，该脚本会将密钥发送到 https://api.crawlora.net/api/v1。
查阅 reference/endpoints.md，了解准确的端点方法和参数。除 HTTP 状态外，还要检查应用程序 code；响应负载位于 data 中。
从范围受限的数据集筛选或搜索请求开始。进行投诉和更多信息查询时，使用返回且已核实的档案 URL。
export CRAWLORA_API_KEY="your-crawlora-api-key"
scripts/crawlora.sh /datasets/bbb-businesses/facets facet=category
scripts/crawlora.sh /bbb/search query="plumbing" location="Austin, TX" page=1

使用搜索返回且已核实的档案 URL：

scripts/crawlora.sh /bbb/business/complaints url="$BBB_PROFILE_URL"
scripts/crawlora.sh /bbb/business/more-info url="$BBB_PROFILE_URL"
技能内容未指定包管理器安装命令；请使用技能文件中随附的脚本，或已连接的 Crawlora MCP 工具。

数据架构

将来源证据与衍生分析作为不同层次保留。相关来源字段和报告细节包括：
数据领域 字段或处理方式
企业身份 企业 ID、名称及别名、地点、网站、总部关系和已核实的档案 URL。
来源出处 来源 ID、URL、来源日期以及观察或抓取时间；分别保留这些时间戳。
汇总指标 total_complaints、返回的 period_text 以及 closed_last_12_months；这些是不同指标，涵盖的时间窗口可能不同。
逐条投诉 投诉 ID、日期、类型、状态、叙述及回应线程角色。按投诉 ID 去重；多个回应轮次属于同一投诉中的观察记录。
状态及删节 保留 BBB 状态，例如 Resolved、Unresolved、Answered、Unanswered 和 Unpursuable。保留 REMOVED 删节内容，不要尝试识别相关人员。
覆盖范围与分析 记录 complaints_list_incomplete、日期筛选条件、受限覆盖范围、逐条样本量、汇总总数、主题标签及不确定性或多标签编码。
支持性背景 在相关时记录来源提供的评级原因；档案中的列表可能较简略，而 more-info 可能提供更完整的逐因素列表。
通过身份和覆盖范围详情、投诉与回应表格，以及主题／状态计数来呈现证据。不要将不可用的逐条列表替换为零投诉，也不要编造主题计数。评价、认证和字母等级是不同的指标。

高级特性

实体和总部核验有助于避免将总部汇总数分配给每个分支机构，或重复计算分支机构与总部记录。
范围受限的 Crawlora 数据收集包括身份验证和应用程序代码检查、429 退避等待，以及对临时上游故障进行一次重试。
当投诉路由没有日期筛选或分页参数时，可通过本地筛选进行日期分析；应披露由此产生的覆盖范围界限。
按投诉 ID 去重，并结合角色和日期分析回应，有助于避免将回应轮次计为不同投诉，或根据四舍五入后的日期推断精确的经过小时数。
主题编码可以保留不确定性和多个标签，并附上简短且注明来源的摘录，以便审计。
可辩护的分母指引确保样本比例基于可比较的已抽样状态，而不是客户总数或时间窗口不匹配的汇总数据。
解读保护措施禁止仅凭投诉数量对投诉率进行排名，或证明欺诈、质量、责任或消费者结果；该研究流程不会提交投诉、联系企业、发布指控或发起法律行动。

name: business-complaint-pattern-analysis description: Analyze public BBB business complaint narratives, response threads, statuses, and reporting-window totals using Crawlora. Use for a sourced complaint-pattern or response-process comparison with business identity, incomplete lists, redactions, allegations, and customer-volume limits preserved.

Business complaint pattern analysis

Access and scope

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the listed 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 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 calls/pages by the requested scope and credit budget. Retain source IDs, URLs, source dates, and observation/crawl times separately.

Compare reported complaint themes or response patterns for selected businesses. Establish business/location scope, reporting/date window, and comparable complaint categories. Keep complainant allegations, business responses, customer replies, and BBB's presented status as distinct attributed evidence.

Resolve the entity and retrieve complaint evidence

Use BBB dataset facets/search or live search to identify exact business profiles. Match business ID, name/alternate names, location, website, and HQ relationships. A multi-location HQ profile can aggregate branches; do not assign its count to each location or combine it with branch counts as independent complaints.
Stored BBB profiles do not embed full complaints. Use the returned profile URL or verified HQ URL with live business/complaints/more-info routes, not a guessed complaint-page slug. Preserve crawl time versus live collection time.
total_complaints has its own reporting window, typically the presented three-year window; closed_last_12_months is a different measure. Retain the returned period_text rather than inventing a common time span across firms. There is no date filter/pagination parameter on the complaints route: filter returned itemized dates locally and mark bounded coverage.
complaints_list_incomplete=true means real aggregate totals can accompany unavailable itemized detail. Do not substitute an empty list for zero complaints or fabricate theme/status counts. A genuine total_complaints=0 can be normal, but it only describes that source/window, not all customers' experience.
Preserve complaint ID, date/type/status, narrative and response-thread roles. BBB statuses include Resolved, Unresolved, Answered, Unanswered, Unpursuable; an answer is not automatically a resolution or admission. Keep BBB's REMOVED redactions intact rather than reconstructing identities.
scripts/crawlora.sh /datasets/bbb-businesses/facets facet=category
scripts/crawlora.sh /bbb/search query="plumbing" location="Austin, TX" page=1

# Use a verified returned profile URL, for example:
# scripts/crawlora.sh /bbb/business/complaints url="$BBB_PROFILE_URL"
# scripts/crawlora.sh /bbb/business/more-info url="$BBB_PROFILE_URL"

Report patterns with defensible denominators

Deduplicate by complaint ID; multiple response rounds are one complaint with several observations. Code themes with uncertain/multi-label states and cite short attributed excerpts. Show itemized sample size, aggregate totals, missing lists, and date filters separately. A sample resolution/response proportion uses that sample's comparable statuses, not the total number of customers or a mismatched aggregate window. Response intervals need actual role/date pairs; a rounded date is not an exact elapsed-hour measurement.

Return identity/coverage, complaint and response evidence tables, theme/status counts, source reasons-for-rating where relevant, and unresolved questions. The main profile's reasons list can be shallow boilerplate; more-info supplies the fuller per-factor list. Reviews, accreditation, and letter grades are separate measures. Counts without comparable customer/transaction volume cannot rank a business's complaint rate or prove fraud, quality, liability, or consumer outcomes. Do not file complaints, contact businesses, publish accusations, or initiate a legal action from a research request.

游戏价格历史研究

ListingsAPI