@roilab/crm-cli 0.1.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/CHANGELOG.md +125 -6
  2. package/SKILL.md +256 -7
  3. package/SURFACE.txt +148 -3
  4. package/dist/bin/crm.js +26 -2
  5. package/dist/bin/crm.js.map +1 -1
  6. package/dist/src/commands/access.js +104 -0
  7. package/dist/src/commands/access.js.map +1 -0
  8. package/dist/src/commands/brief.js +52 -0
  9. package/dist/src/commands/brief.js.map +1 -0
  10. package/dist/src/commands/chat.js +203 -0
  11. package/dist/src/commands/chat.js.map +1 -0
  12. package/dist/src/commands/commands.js +89 -0
  13. package/dist/src/commands/commands.js.map +1 -0
  14. package/dist/src/commands/comment.js +1 -0
  15. package/dist/src/commands/comment.js.map +1 -1
  16. package/dist/src/commands/generic.js +335 -5
  17. package/dist/src/commands/generic.js.map +1 -1
  18. package/dist/src/commands/integrations.js +236 -0
  19. package/dist/src/commands/integrations.js.map +1 -0
  20. package/dist/src/commands/mention.js +139 -0
  21. package/dist/src/commands/mention.js.map +1 -0
  22. package/dist/src/commands/options.js +21 -1
  23. package/dist/src/commands/options.js.map +1 -1
  24. package/dist/src/commands/report.js +209 -0
  25. package/dist/src/commands/report.js.map +1 -0
  26. package/dist/src/commands/review.js +136 -0
  27. package/dist/src/commands/review.js.map +1 -1
  28. package/dist/src/commands/skill.js +836 -0
  29. package/dist/src/commands/skill.js.map +1 -0
  30. package/dist/src/commands/task.js +298 -4
  31. package/dist/src/commands/task.js.map +1 -1
  32. package/dist/src/commands/time.js +242 -0
  33. package/dist/src/commands/time.js.map +1 -0
  34. package/dist/src/lib/skillBundles.js +84 -0
  35. package/dist/src/lib/skillBundles.js.map +1 -0
  36. package/dist/src/lib/skillManifest.js +77 -0
  37. package/dist/src/lib/skillManifest.js.map +1 -0
  38. package/dist/src/lib/skillSidecar.js +69 -0
  39. package/dist/src/lib/skillSidecar.js.map +1 -0
  40. package/dist/src/lib/skillWriter.js +162 -0
  41. package/dist/src/lib/skillWriter.js.map +1 -0
  42. package/dist/src/transport/envelope.js +12 -2
  43. package/dist/src/transport/envelope.js.map +1 -1
  44. package/dist/src/transport/http.js +27 -0
  45. package/dist/src/transport/http.js.map +1 -1
  46. package/dist/src/transport/run.js +6 -0
  47. package/dist/src/transport/run.js.map +1 -1
  48. package/dist/src/types.js.map +1 -1
  49. package/dist/src/utils/server-nudge.js +57 -0
  50. package/dist/src/utils/server-nudge.js.map +1 -0
  51. package/dist/src/utils/version-check.js +68 -0
  52. package/dist/src/utils/version-check.js.map +1 -1
  53. package/package.json +2 -1
  54. package/skill-bundles/tools/ahrefs-tool/SKILL.md +134 -0
  55. package/skill-bundles/tools/brightlocal-tool/SKILL.md +154 -0
  56. package/skill-bundles/tools/dataforseo-tool/SKILL.md +118 -0
  57. package/skill-bundles/tools/google-analytics-tool/SKILL.md +143 -0
  58. package/skill-bundles/tools/google-search-console-tool/SKILL.md +133 -0
  59. package/skill-bundles/tools/local-falcon-tool/SKILL.md +142 -0
  60. package/skill-bundles/tools/localseodata-tool/SKILL.md +388 -0
  61. package/skill-bundles/tools/lsa-spy-tool/SKILL.md +113 -0
  62. package/skill-bundles/tools/screaming-frog-tool/SKILL.md +166 -0
  63. package/skill-bundles/tools/semrush-tool/SKILL.md +121 -0
  64. package/skill-bundles/tools/serpapi-tool/SKILL.md +148 -0
  65. package/skill-bundles/tools/task-preflight/SKILL.md +149 -0
  66. package/skill-bundles/tools/tool-routing/SKILL.md +59 -0
  67. package/skill-bundles/tools/whitespark-tool/SKILL.md +129 -0
@@ -0,0 +1,129 @@
1
+ ---
2
+ name: whitespark-tool
3
+ description: When the user wants citation gap analysis, managed citation building, review generation campaigns, or local rank tracking. Trigger on "Whitespark," "citation finder," "where are my competitors listed," "citation gap," "build citations," "review generation tool," or "get more reviews." Note that Whitespark does NOT have an MCP server — it's dashboard-driven with limited API.
4
+ ---
5
+
6
+ # Whitespark Tool
7
+
8
+ > **Note:** LocalSEOData (`localseodata-tool`) now covers citation audits via `citation_audit`. Use LocalSEOData as default for citation data. Whitespark remains the preferred tool for citation building and review generation campaigns (Reputation Builder).
9
+
10
+ Whitespark does NOT currently have an MCP server. It's primarily a dashboard tool with managed services. The agent's role is to guide what to do in Whitespark and interpret data the user provides from it.
11
+
12
+ ## When to Use Whitespark vs Other Tools
13
+
14
+ | You Need | Use Whitespark | Use Instead |
15
+ |----------|---------------|-------------|
16
+ | Citation gap analysis (competitor vs you) | ✅ Local Citation Finder | BrightLocal (also does this, has MCP) |
17
+ | Managed citation building (done-for-you) | ✅ Best quality service | BrightLocal (also offers this) |
18
+ | Review generation campaigns (email/SMS) | ✅ Reputation Builder | — |
19
+ | Review monitoring | ✅ | BrightLocal (has MCP, may be better for agent access) |
20
+ | Local rank tracking | ✅ | Local Falcon (geogrid is superior for local) |
21
+ | Citation accuracy audit | ⚠️ Can do it | BrightLocal (better for NAP accuracy scoring) |
22
+ | Keyword research | ❌ | Semrush, Ahrefs |
23
+ | Backlink analysis | ❌ | Ahrefs |
24
+ | Technical audit | ❌ | Screaming Frog |
25
+ | Geogrid rankings | ❌ | Local Falcon |
26
+
27
+ ## Whitespark vs BrightLocal
28
+
29
+ These two overlap significantly. Here's when to use which:
30
+
31
+ | Feature | Whitespark | BrightLocal |
32
+ |---------|-----------|-------------|
33
+ | Citation building quality | ✅ Higher quality (manual review) | Good but more automated |
34
+ | Citation gap finder | ✅ More thorough | ✅ Also good |
35
+ | NAP accuracy scoring | Basic | ✅ Better scoring system |
36
+ | MCP server available | ❌ No | ✅ Yes |
37
+ | Review generation | ✅ Reputation Builder | ✅ Also has this |
38
+ | White-label reports | Basic | ✅ Better reporting |
39
+ | Industry reputation | ✅ Citation specialists | ✅ All-in-one local SEO |
40
+ | Pricing | Per-service | Subscription |
41
+
42
+ **Recommendation:** If MCP connectivity matters (agent can pull data directly), use BrightLocal. If citation building quality is the priority and the user is willing to use the dashboard, Whitespark's managed service is excellent.
43
+
44
+ ## Core Workflows
45
+
46
+ ### Citation Gap Analysis
47
+
48
+ **When:** User wants to find directories where competitors are listed but they aren't.
49
+
50
+ **What to do in Whitespark:**
51
+ 1. Run Local Citation Finder for target business AND 2-3 competitors
52
+ 2. Compare citation sources across all businesses
53
+ 3. Identify directories where competitors appear but user doesn't
54
+
55
+ **What the agent can do:**
56
+ - Guide the user on which competitors to check
57
+ - Interpret the citation gap report when the user shares results
58
+ - Prioritize which directories to target first
59
+
60
+ **Citation priority framework:**
61
+ 1. **Tier 1** (must-have): Google, Apple, Bing, Yelp, Facebook, data aggregators
62
+ 2. **Tier 2** (important): Industry-specific directories (Healthgrades, Avvo, Angi, etc.)
63
+ 3. **Tier 3** (nice-to-have): Local directories, chamber of commerce, BBB
64
+ 4. **Tier 4** (low priority): General web directories, niche sites
65
+
66
+ ### Managed Citation Building
67
+
68
+ **When:** Citation gaps identified and user wants help building them.
69
+
70
+ **What Whitespark does:**
71
+ - Manual submission to directories (higher quality than automated tools)
72
+ - Verification that listings are live and accurate
73
+ - Ongoing maintenance options
74
+
75
+ **What to tell the user:**
76
+ 1. Provide exact NAP (must match GBP)
77
+ 2. Provide business description, categories, photos
78
+ 3. Specify target directories from the gap analysis
79
+ 4. Expect 2-4 week turnaround for most directories
80
+ 5. Re-audit in 6-8 weeks to verify everything is live and accurate
81
+
82
+ ### Review Generation (Reputation Builder)
83
+
84
+ **When:** User needs to systematically generate more Google reviews.
85
+
86
+ **How Reputation Builder works:**
87
+ - Import customer list (email or phone)
88
+ - Send automated review request via email or SMS
89
+ - Directs happy customers to Google review page
90
+ - Tracks who received requests, who left reviews
91
+
92
+ **What the agent should guide:**
93
+ 1. **Timing**: Send review requests 1-3 days after service completion
94
+ 2. **Message**: Keep it short, personal, include direct Google review link
95
+ 3. **Volume**: Steady stream (5-10/week) is better than burst of 50
96
+ 4. **Filtering**: Don't send to known unhappy customers (avoid negative reviews)
97
+ 5. **Compliance**: Don't incentivize reviews, don't gate (filter based on rating)
98
+
99
+ **Review velocity targets by business type:**
100
+ | Business Type | Monthly Review Target | Rationale |
101
+ |---------------|----------------------|-----------|
102
+ | Restaurant | 15-30 | High transaction volume |
103
+ | Medical practice | 8-15 | Moderate patient volume |
104
+ | Home services | 5-10 | Lower transaction frequency |
105
+ | Legal | 3-5 | Fewer clients, harder to ask |
106
+ | B2B services | 2-4 | Low volume, high value |
107
+
108
+ ### Local Rank Tracking
109
+
110
+ **When:** User uses Whitespark's rank tracker.
111
+
112
+ **Whitespark's rank tracker** is point-based (single location), not geogrid.
113
+
114
+ **What the agent should know:**
115
+ - This shows ranking at ONE point for a keyword — not geographic coverage
116
+ - For local businesses, Local Falcon geogrid is far more useful
117
+ - Whitespark rank tracking is fine for organic keyword tracking alongside geogrid
118
+
119
+ ## What to Do Next
120
+
121
+ | What You Found | Next Action | Skill |
122
+ |----------------|-------------|-------|
123
+ | Citation gaps identified | Build missing citations, starting with Tier 1 | `local-citations` |
124
+ | Citations built, waiting for propagation | Work on other optimization while waiting (4-8 weeks) | `gbp-optimization`, `review-management` |
125
+ | Review generation campaign running | Monitor velocity and adjust messaging if response rate is low | `review-management` |
126
+ | Citation data needs to go in a report | Include in audit or monthly report | `client-deliverables`, `local-reporting` |
127
+ | Need MCP-accessible citation data | Use BrightLocal instead | `brightlocal-tool` |
128
+
129
+ **Default next step:** Whitespark's strength is managed citation services. If you need automated, agent-accessible citation data, use BrightLocal. If you need the highest-quality citation building, use Whitespark's managed service.