@miranda0808/maya-codex 0.1.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 (270) hide show
  1. package/README.md +30 -0
  2. package/bin/maya-codex.js +36 -0
  3. package/package.json +19 -0
  4. package/payload/.agents/skills/ab-test-setup/SKILL.md +266 -0
  5. package/payload/.agents/skills/ab-test-setup/evals/evals.json +105 -0
  6. package/payload/.agents/skills/ab-test-setup/references/sample-size-guide.md +263 -0
  7. package/payload/.agents/skills/ab-test-setup/references/test-templates.md +277 -0
  8. package/payload/.agents/skills/ad-creative/SKILL.md +362 -0
  9. package/payload/.agents/skills/ad-creative/evals/evals.json +90 -0
  10. package/payload/.agents/skills/ad-creative/references/generative-tools.md +637 -0
  11. package/payload/.agents/skills/ad-creative/references/platform-specs.md +213 -0
  12. package/payload/.agents/skills/ai-seo/SKILL.md +398 -0
  13. package/payload/.agents/skills/ai-seo/evals/evals.json +90 -0
  14. package/payload/.agents/skills/ai-seo/references/content-patterns.md +285 -0
  15. package/payload/.agents/skills/ai-seo/references/platform-ranking-factors.md +152 -0
  16. package/payload/.agents/skills/analytics-tracking/SKILL.md +309 -0
  17. package/payload/.agents/skills/analytics-tracking/evals/evals.json +90 -0
  18. package/payload/.agents/skills/analytics-tracking/references/event-library.md +260 -0
  19. package/payload/.agents/skills/analytics-tracking/references/ga4-implementation.md +300 -0
  20. package/payload/.agents/skills/analytics-tracking/references/gtm-implementation.md +390 -0
  21. package/payload/.agents/skills/churn-prevention/SKILL.md +424 -0
  22. package/payload/.agents/skills/churn-prevention/evals/evals.json +93 -0
  23. package/payload/.agents/skills/churn-prevention/references/cancel-flow-patterns.md +316 -0
  24. package/payload/.agents/skills/churn-prevention/references/dunning-playbook.md +408 -0
  25. package/payload/.agents/skills/cold-email/SKILL.md +158 -0
  26. package/payload/.agents/skills/cold-email/evals/evals.json +94 -0
  27. package/payload/.agents/skills/cold-email/references/benchmarks.md +83 -0
  28. package/payload/.agents/skills/cold-email/references/follow-up-sequences.md +81 -0
  29. package/payload/.agents/skills/cold-email/references/frameworks.md +90 -0
  30. package/payload/.agents/skills/cold-email/references/personalization.md +79 -0
  31. package/payload/.agents/skills/cold-email/references/subject-lines.md +53 -0
  32. package/payload/.agents/skills/competitor-alternatives/SKILL.md +256 -0
  33. package/payload/.agents/skills/competitor-alternatives/evals/evals.json +93 -0
  34. package/payload/.agents/skills/competitor-alternatives/references/content-architecture.md +271 -0
  35. package/payload/.agents/skills/competitor-alternatives/references/templates.md +223 -0
  36. package/payload/.agents/skills/content-strategy/SKILL.md +359 -0
  37. package/payload/.agents/skills/content-strategy/evals/evals.json +90 -0
  38. package/payload/.agents/skills/copy-editing/SKILL.md +447 -0
  39. package/payload/.agents/skills/copy-editing/evals/evals.json +89 -0
  40. package/payload/.agents/skills/copy-editing/references/plain-english-alternatives.md +394 -0
  41. package/payload/.agents/skills/copywriting/SKILL.md +252 -0
  42. package/payload/.agents/skills/copywriting/evals/evals.json +111 -0
  43. package/payload/.agents/skills/copywriting/references/copy-frameworks.md +344 -0
  44. package/payload/.agents/skills/copywriting/references/natural-transitions.md +272 -0
  45. package/payload/.agents/skills/email-sequence/SKILL.md +309 -0
  46. package/payload/.agents/skills/email-sequence/evals/evals.json +93 -0
  47. package/payload/.agents/skills/email-sequence/references/copy-guidelines.md +113 -0
  48. package/payload/.agents/skills/email-sequence/references/email-types.md +515 -0
  49. package/payload/.agents/skills/email-sequence/references/sequence-templates.md +168 -0
  50. package/payload/.agents/skills/form-cro/SKILL.md +429 -0
  51. package/payload/.agents/skills/form-cro/evals/evals.json +90 -0
  52. package/payload/.agents/skills/free-tool-strategy/SKILL.md +178 -0
  53. package/payload/.agents/skills/free-tool-strategy/evals/evals.json +90 -0
  54. package/payload/.agents/skills/free-tool-strategy/references/tool-types.md +217 -0
  55. package/payload/.agents/skills/launch-strategy/SKILL.md +353 -0
  56. package/payload/.agents/skills/launch-strategy/evals/evals.json +91 -0
  57. package/payload/.agents/skills/marketing-ideas/SKILL.md +167 -0
  58. package/payload/.agents/skills/marketing-ideas/evals/evals.json +90 -0
  59. package/payload/.agents/skills/marketing-ideas/references/ideas-by-category.md +366 -0
  60. package/payload/.agents/skills/marketing-psychology/SKILL.md +455 -0
  61. package/payload/.agents/skills/marketing-psychology/evals/evals.json +88 -0
  62. package/payload/.agents/skills/onboarding-cro/SKILL.md +220 -0
  63. package/payload/.agents/skills/onboarding-cro/evals/evals.json +92 -0
  64. package/payload/.agents/skills/onboarding-cro/references/experiments.md +258 -0
  65. package/payload/.agents/skills/page-cro/SKILL.md +182 -0
  66. package/payload/.agents/skills/page-cro/evals/evals.json +111 -0
  67. package/payload/.agents/skills/page-cro/references/experiments.md +248 -0
  68. package/payload/.agents/skills/paid-ads/SKILL.md +315 -0
  69. package/payload/.agents/skills/paid-ads/evals/evals.json +90 -0
  70. package/payload/.agents/skills/paid-ads/references/ad-copy-templates.md +207 -0
  71. package/payload/.agents/skills/paid-ads/references/audience-targeting.md +243 -0
  72. package/payload/.agents/skills/paid-ads/references/platform-setup-checklists.md +277 -0
  73. package/payload/.agents/skills/paywall-upgrade-cro/SKILL.md +227 -0
  74. package/payload/.agents/skills/paywall-upgrade-cro/evals/evals.json +93 -0
  75. package/payload/.agents/skills/paywall-upgrade-cro/references/experiments.md +164 -0
  76. package/payload/.agents/skills/popup-cro/SKILL.md +453 -0
  77. package/payload/.agents/skills/popup-cro/evals/evals.json +94 -0
  78. package/payload/.agents/skills/pricing-strategy/SKILL.md +231 -0
  79. package/payload/.agents/skills/pricing-strategy/evals/evals.json +90 -0
  80. package/payload/.agents/skills/pricing-strategy/references/research-methods.md +152 -0
  81. package/payload/.agents/skills/pricing-strategy/references/tier-structure.md +232 -0
  82. package/payload/.agents/skills/product-marketing-context/SKILL.md +27 -0
  83. package/payload/.agents/skills/product-marketing-context/evals/evals.json +40 -0
  84. package/payload/.agents/skills/programmatic-seo/SKILL.md +238 -0
  85. package/payload/.agents/skills/programmatic-seo/evals/evals.json +94 -0
  86. package/payload/.agents/skills/programmatic-seo/references/playbooks.md +308 -0
  87. package/payload/.agents/skills/referral-program/SKILL.md +255 -0
  88. package/payload/.agents/skills/referral-program/evals/evals.json +89 -0
  89. package/payload/.agents/skills/referral-program/references/affiliate-programs.md +164 -0
  90. package/payload/.agents/skills/referral-program/references/program-examples.md +143 -0
  91. package/payload/.agents/skills/revops/SKILL.md +343 -0
  92. package/payload/.agents/skills/revops/evals/evals.json +91 -0
  93. package/payload/.agents/skills/revops/references/automation-playbooks.md +290 -0
  94. package/payload/.agents/skills/revops/references/lifecycle-definitions.md +278 -0
  95. package/payload/.agents/skills/revops/references/routing-rules.md +203 -0
  96. package/payload/.agents/skills/revops/references/scoring-models.md +247 -0
  97. package/payload/.agents/skills/sales-enablement/SKILL.md +349 -0
  98. package/payload/.agents/skills/sales-enablement/evals/evals.json +91 -0
  99. package/payload/.agents/skills/sales-enablement/references/deck-frameworks.md +263 -0
  100. package/payload/.agents/skills/sales-enablement/references/demo-scripts.md +355 -0
  101. package/payload/.agents/skills/sales-enablement/references/objection-library.md +270 -0
  102. package/payload/.agents/skills/sales-enablement/references/one-pager-templates.md +208 -0
  103. package/payload/.agents/skills/schema-markup/SKILL.md +179 -0
  104. package/payload/.agents/skills/schema-markup/evals/evals.json +87 -0
  105. package/payload/.agents/skills/schema-markup/references/schema-examples.md +398 -0
  106. package/payload/.agents/skills/seo-audit/SKILL.md +412 -0
  107. package/payload/.agents/skills/seo-audit/evals/evals.json +136 -0
  108. package/payload/.agents/skills/seo-audit/references/ai-writing-detection.md +200 -0
  109. package/payload/.agents/skills/signup-flow-cro/SKILL.md +359 -0
  110. package/payload/.agents/skills/signup-flow-cro/evals/evals.json +88 -0
  111. package/payload/.agents/skills/site-architecture/SKILL.md +357 -0
  112. package/payload/.agents/skills/site-architecture/evals/evals.json +88 -0
  113. package/payload/.agents/skills/site-architecture/references/mermaid-templates.md +216 -0
  114. package/payload/.agents/skills/site-architecture/references/navigation-patterns.md +305 -0
  115. package/payload/.agents/skills/site-architecture/references/site-type-templates.md +293 -0
  116. package/payload/.agents/skills/social-content/SKILL.md +278 -0
  117. package/payload/.agents/skills/social-content/evals/evals.json +92 -0
  118. package/payload/.agents/skills/social-content/references/platforms.md +170 -0
  119. package/payload/.agents/skills/social-content/references/post-templates.md +177 -0
  120. package/payload/.agents/skills/social-content/references/reverse-engineering.md +195 -0
  121. package/payload/.maya/executor.md +79 -0
  122. package/payload/.maya/meta-api-agent.md +48 -0
  123. package/payload/.maya/modes/consult.md +63 -0
  124. package/payload/.maya/modes/task.md +97 -0
  125. package/payload/.maya/planner.md +69 -0
  126. package/payload/.maya/researcher.md +51 -0
  127. package/payload/.maya/templates/plan.md +77 -0
  128. package/payload/.maya/templates/state.md +87 -0
  129. package/payload/.maya/templates/task-packet.md +75 -0
  130. package/payload/MAYA-CATALOG.md +115 -0
  131. package/payload/MAYA-DEPENDENCIES.md +58 -0
  132. package/payload/MAYA.md +151 -0
  133. package/payload/campaigns/README.md +14 -0
  134. package/payload/commands/maya-consult.md +28 -0
  135. package/payload/commands/maya-task.md +38 -0
  136. package/payload/commands/product.md +55 -0
  137. package/payload/research/README.md +14 -0
  138. package/payload/templates/README.md +15 -0
  139. package/payload/templates/plan.md +77 -0
  140. package/payload/templates/state.md +87 -0
  141. package/payload/templates/task-packet.md +75 -0
  142. package/payload/tools/REGISTRY.md +368 -0
  143. package/payload/tools/clis/README.md +187 -0
  144. package/payload/tools/clis/activecampaign.js +435 -0
  145. package/payload/tools/clis/adobe-analytics.js +161 -0
  146. package/payload/tools/clis/ahrefs.js +192 -0
  147. package/payload/tools/clis/amplitude.js +182 -0
  148. package/payload/tools/clis/apollo.js +142 -0
  149. package/payload/tools/clis/beehiiv.js +245 -0
  150. package/payload/tools/clis/brevo.js +368 -0
  151. package/payload/tools/clis/buffer.js +260 -0
  152. package/payload/tools/clis/calendly.js +253 -0
  153. package/payload/tools/clis/clearbit.js +163 -0
  154. package/payload/tools/clis/customer-io.js +205 -0
  155. package/payload/tools/clis/dataforseo.js +257 -0
  156. package/payload/tools/clis/demio.js +149 -0
  157. package/payload/tools/clis/dub.js +158 -0
  158. package/payload/tools/clis/g2.js +186 -0
  159. package/payload/tools/clis/ga4.js +194 -0
  160. package/payload/tools/clis/google-ads.js +189 -0
  161. package/payload/tools/clis/google-search-console.js +166 -0
  162. package/payload/tools/clis/hotjar.js +167 -0
  163. package/payload/tools/clis/hunter.js +249 -0
  164. package/payload/tools/clis/instantly.js +270 -0
  165. package/payload/tools/clis/intercom.js +399 -0
  166. package/payload/tools/clis/keywords-everywhere.js +185 -0
  167. package/payload/tools/clis/kit.js +232 -0
  168. package/payload/tools/clis/klaviyo.js +348 -0
  169. package/payload/tools/clis/lemlist.js +221 -0
  170. package/payload/tools/clis/linkedin-ads.js +185 -0
  171. package/payload/tools/clis/livestorm.js +292 -0
  172. package/payload/tools/clis/mailchimp.js +220 -0
  173. package/payload/tools/clis/mention-me.js +161 -0
  174. package/payload/tools/clis/meta-ads.js +181 -0
  175. package/payload/tools/clis/mixpanel.js +248 -0
  176. package/payload/tools/clis/onesignal.js +241 -0
  177. package/payload/tools/clis/optimizely.js +233 -0
  178. package/payload/tools/clis/paddle.js +385 -0
  179. package/payload/tools/clis/partnerstack.js +382 -0
  180. package/payload/tools/clis/plausible.js +249 -0
  181. package/payload/tools/clis/postmark.js +375 -0
  182. package/payload/tools/clis/resend.js +370 -0
  183. package/payload/tools/clis/rewardful.js +160 -0
  184. package/payload/tools/clis/savvycal.js +223 -0
  185. package/payload/tools/clis/segment.js +192 -0
  186. package/payload/tools/clis/semrush.js +207 -0
  187. package/payload/tools/clis/sendgrid.js +211 -0
  188. package/payload/tools/clis/snov.js +237 -0
  189. package/payload/tools/clis/tiktok-ads.js +190 -0
  190. package/payload/tools/clis/tolt.js +153 -0
  191. package/payload/tools/clis/trustpilot.js +276 -0
  192. package/payload/tools/clis/typeform.js +269 -0
  193. package/payload/tools/clis/wistia.js +256 -0
  194. package/payload/tools/clis/zapier.js +160 -0
  195. package/payload/tools/integrations/activecampaign.md +337 -0
  196. package/payload/tools/integrations/adobe-analytics.md +156 -0
  197. package/payload/tools/integrations/ahrefs.md +142 -0
  198. package/payload/tools/integrations/amplitude.md +135 -0
  199. package/payload/tools/integrations/apollo.md +148 -0
  200. package/payload/tools/integrations/beehiiv.md +157 -0
  201. package/payload/tools/integrations/brevo.md +268 -0
  202. package/payload/tools/integrations/buffer.md +138 -0
  203. package/payload/tools/integrations/calendly.md +161 -0
  204. package/payload/tools/integrations/clearbit.md +142 -0
  205. package/payload/tools/integrations/customer-io.md +187 -0
  206. package/payload/tools/integrations/dataforseo.md +165 -0
  207. package/payload/tools/integrations/demio.md +182 -0
  208. package/payload/tools/integrations/dub-co.md +160 -0
  209. package/payload/tools/integrations/g2.md +179 -0
  210. package/payload/tools/integrations/ga4.md +126 -0
  211. package/payload/tools/integrations/google-ads.md +159 -0
  212. package/payload/tools/integrations/google-search-console.md +147 -0
  213. package/payload/tools/integrations/hotjar.md +147 -0
  214. package/payload/tools/integrations/hubspot.md +178 -0
  215. package/payload/tools/integrations/hunter.md +90 -0
  216. package/payload/tools/integrations/instantly.md +104 -0
  217. package/payload/tools/integrations/intercom.md +292 -0
  218. package/payload/tools/integrations/keywords-everywhere.md +207 -0
  219. package/payload/tools/integrations/kit.md +167 -0
  220. package/payload/tools/integrations/klaviyo.md +228 -0
  221. package/payload/tools/integrations/lemlist.md +110 -0
  222. package/payload/tools/integrations/linkedin-ads.md +164 -0
  223. package/payload/tools/integrations/livestorm.md +313 -0
  224. package/payload/tools/integrations/mailchimp.md +150 -0
  225. package/payload/tools/integrations/mention-me.md +160 -0
  226. package/payload/tools/integrations/meta-ads.md +147 -0
  227. package/payload/tools/integrations/mixpanel.md +137 -0
  228. package/payload/tools/integrations/onesignal.md +229 -0
  229. package/payload/tools/integrations/optimizely.md +171 -0
  230. package/payload/tools/integrations/paddle.md +212 -0
  231. package/payload/tools/integrations/partnerstack.md +222 -0
  232. package/payload/tools/integrations/plausible.md +177 -0
  233. package/payload/tools/integrations/posthog.md +151 -0
  234. package/payload/tools/integrations/postmark.md +234 -0
  235. package/payload/tools/integrations/resend.md +168 -0
  236. package/payload/tools/integrations/rewardful.md +147 -0
  237. package/payload/tools/integrations/salesforce.md +150 -0
  238. package/payload/tools/integrations/savvycal.md +181 -0
  239. package/payload/tools/integrations/segment.md +159 -0
  240. package/payload/tools/integrations/semrush.md +121 -0
  241. package/payload/tools/integrations/sendgrid.md +161 -0
  242. package/payload/tools/integrations/shopify.md +176 -0
  243. package/payload/tools/integrations/snov.md +94 -0
  244. package/payload/tools/integrations/stripe.md +148 -0
  245. package/payload/tools/integrations/tiktok-ads.md +161 -0
  246. package/payload/tools/integrations/tolt.md +144 -0
  247. package/payload/tools/integrations/trustpilot.md +191 -0
  248. package/payload/tools/integrations/typeform.md +190 -0
  249. package/payload/tools/integrations/webflow.md +198 -0
  250. package/payload/tools/integrations/wistia.md +164 -0
  251. package/payload/tools/integrations/wordpress.md +175 -0
  252. package/payload/tools/integrations/zapier.md +150 -0
  253. package/payload/tools/meta/README.md +55 -0
  254. package/payload/tools/meta/meta-cache-schema.md +65 -0
  255. package/payload/tools/meta/meta-fetch.ps1 +324 -0
  256. package/payload/tools/meta/meta-fetch.test.ps1 +38 -0
  257. package/vendor/shared-installer/manifests/claude-files.json +13 -0
  258. package/vendor/shared-installer/manifests/codex-files.json +13 -0
  259. package/vendor/shared-installer/manifests/common-files.json +13 -0
  260. package/vendor/shared-installer/package.json +15 -0
  261. package/vendor/shared-installer/src/bootstrap.js +12 -0
  262. package/vendor/shared-installer/src/cli-options.js +53 -0
  263. package/vendor/shared-installer/src/fs.js +105 -0
  264. package/vendor/shared-installer/src/index.js +44 -0
  265. package/vendor/shared-installer/src/install.js +157 -0
  266. package/vendor/shared-installer/src/manifest.js +52 -0
  267. package/vendor/shared-installer/templates/claude/.claude/skills/.gitkeep +1 -0
  268. package/vendor/shared-installer/templates/claude/CLAUDE.md +27 -0
  269. package/vendor/shared-installer/templates/codex/.agent/skills/.gitkeep +1 -0
  270. package/vendor/shared-installer/templates/codex/AGENTS.md +27 -0
@@ -0,0 +1,158 @@
1
+ #!/usr/bin/env node
2
+
3
+ const API_KEY = process.env.DUB_API_KEY
4
+ const BASE_URL = 'https://api.dub.co'
5
+
6
+ if (!API_KEY) {
7
+ console.error(JSON.stringify({ error: 'DUB_API_KEY environment variable required' }))
8
+ process.exit(1)
9
+ }
10
+
11
+ async function api(method, path, body) {
12
+ if (args['dry-run']) {
13
+ return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined }
14
+ }
15
+ const res = await fetch(`${BASE_URL}${path}`, {
16
+ method,
17
+ headers: {
18
+ 'Authorization': `Bearer ${API_KEY}`,
19
+ 'Content-Type': 'application/json',
20
+ },
21
+ body: body ? JSON.stringify(body) : undefined,
22
+ })
23
+ const text = await res.text()
24
+ try {
25
+ return JSON.parse(text)
26
+ } catch {
27
+ return { status: res.status, body: text }
28
+ }
29
+ }
30
+
31
+ function parseArgs(args) {
32
+ const result = { _: [] }
33
+ for (let i = 0; i < args.length; i++) {
34
+ const arg = args[i]
35
+ if (arg.startsWith('--')) {
36
+ const key = arg.slice(2)
37
+ const next = args[i + 1]
38
+ if (next && !next.startsWith('--')) {
39
+ result[key] = next
40
+ i++
41
+ } else {
42
+ result[key] = true
43
+ }
44
+ } else {
45
+ result._.push(arg)
46
+ }
47
+ }
48
+ return result
49
+ }
50
+
51
+ const args = parseArgs(process.argv.slice(2))
52
+ const [cmd, sub, ...rest] = args._
53
+
54
+ async function main() {
55
+ let result
56
+
57
+ switch (cmd) {
58
+ case 'links':
59
+ switch (sub) {
60
+ case 'create': {
61
+ if (!args.url) { result = { error: '--url required' }; break }
62
+ const body = {}
63
+ if (args.url) body.url = args.url
64
+ if (args.domain) body.domain = args.domain
65
+ if (args.key) body.key = args.key
66
+ if (args.tags) body.tags = args.tags.split(',')
67
+ result = await api('POST', '/links', body)
68
+ break
69
+ }
70
+ case 'list': {
71
+ const params = new URLSearchParams()
72
+ if (args.domain) params.set('domain', args.domain)
73
+ if (args.page) params.set('page', args.page)
74
+ result = await api('GET', `/links?${params}`)
75
+ break
76
+ }
77
+ case 'get': {
78
+ const params = new URLSearchParams()
79
+ if (args.domain) params.set('domain', args.domain)
80
+ if (args.key) params.set('key', args.key)
81
+ if (args['link-id']) params.set('linkId', args['link-id'])
82
+ if (args['external-id']) params.set('externalId', args['external-id'])
83
+ result = await api('GET', `/links/info?${params}`)
84
+ break
85
+ }
86
+ case 'update': {
87
+ if (!args.id) { result = { error: '--id required (link ID)' }; break }
88
+ const body = {}
89
+ if (args.url) body.url = args.url
90
+ if (args.tags) body.tags = args.tags.split(',')
91
+ result = await api('PATCH', `/links/${args.id}`, body)
92
+ break
93
+ }
94
+ case 'delete':
95
+ if (!args.id) { result = { error: '--id required (link ID)' }; break }
96
+ result = await api('DELETE', `/links/${args.id}`)
97
+ break
98
+ case 'bulk-create': {
99
+ let links
100
+ try {
101
+ links = JSON.parse(args.links || '[]')
102
+ } catch {
103
+ result = { error: 'Invalid JSON in --links' }; break
104
+ }
105
+ result = await api('POST', '/links/bulk', links)
106
+ break
107
+ }
108
+ default:
109
+ result = { error: 'Unknown links subcommand. Use: create, list, get, update, delete, bulk-create' }
110
+ }
111
+ break
112
+
113
+ case 'analytics':
114
+ switch (sub) {
115
+ case 'get': {
116
+ const params = new URLSearchParams()
117
+ if (args.domain) params.set('domain', args.domain)
118
+ if (args.key) params.set('key', args.key)
119
+ if (args.interval) params.set('interval', args.interval)
120
+ result = await api('GET', `/analytics?${params}`)
121
+ break
122
+ }
123
+ case 'country': {
124
+ const params = new URLSearchParams()
125
+ if (args.domain) params.set('domain', args.domain)
126
+ if (args.key) params.set('key', args.key)
127
+ result = await api('GET', `/analytics/country?${params}`)
128
+ break
129
+ }
130
+ case 'device': {
131
+ const params = new URLSearchParams()
132
+ if (args.domain) params.set('domain', args.domain)
133
+ if (args.key) params.set('key', args.key)
134
+ result = await api('GET', `/analytics/device?${params}`)
135
+ break
136
+ }
137
+ default:
138
+ result = { error: 'Unknown analytics subcommand. Use: get, country, device' }
139
+ }
140
+ break
141
+
142
+ default:
143
+ result = {
144
+ error: 'Unknown command',
145
+ usage: {
146
+ links: 'links [create|list|get|update|delete|bulk-create] [--url <url>] [--domain <domain>] [--key <key>] [--tags <tags>] [--id <id>] [--page <page>] [--links <json>]',
147
+ analytics: 'analytics [get|country|device] [--domain <domain>] [--key <key>] [--interval <interval>]',
148
+ }
149
+ }
150
+ }
151
+
152
+ console.log(JSON.stringify(result, null, 2))
153
+ }
154
+
155
+ main().catch(err => {
156
+ console.error(JSON.stringify({ error: err.message }))
157
+ process.exit(1)
158
+ })
@@ -0,0 +1,186 @@
1
+ #!/usr/bin/env node
2
+
3
+ const API_TOKEN = process.env.G2_API_TOKEN
4
+ const BASE_URL = 'https://data.g2.com/api/v1'
5
+
6
+ if (!API_TOKEN) {
7
+ console.error(JSON.stringify({ error: 'G2_API_TOKEN environment variable required' }))
8
+ process.exit(1)
9
+ }
10
+
11
+ async function api(method, path, body) {
12
+ if (args['dry-run']) {
13
+ return { _dry_run: true, method, url: `${BASE_URL}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/vnd.api+json', Accept: 'application/vnd.api+json' }, body: body || undefined }
14
+ }
15
+ const res = await fetch(`${BASE_URL}${path}`, {
16
+ method,
17
+ headers: {
18
+ 'Authorization': `Token token=${API_TOKEN}`,
19
+ 'Content-Type': 'application/vnd.api+json',
20
+ 'Accept': 'application/vnd.api+json',
21
+ },
22
+ body: body ? JSON.stringify(body) : undefined,
23
+ })
24
+ const text = await res.text()
25
+ try {
26
+ return JSON.parse(text)
27
+ } catch {
28
+ return { status: res.status, body: text }
29
+ }
30
+ }
31
+
32
+ function parseArgs(args) {
33
+ const result = { _: [] }
34
+ for (let i = 0; i < args.length; i++) {
35
+ const arg = args[i]
36
+ if (arg.startsWith('--')) {
37
+ const key = arg.slice(2)
38
+ const next = args[i + 1]
39
+ if (next && !next.startsWith('--')) {
40
+ result[key] = next
41
+ i++
42
+ } else {
43
+ result[key] = true
44
+ }
45
+ } else {
46
+ result._.push(arg)
47
+ }
48
+ }
49
+ return result
50
+ }
51
+
52
+ const args = parseArgs(process.argv.slice(2))
53
+ const [cmd, sub, ...rest] = args._
54
+
55
+ async function main() {
56
+ let result
57
+ const page = args.page ? Number(args.page) : 1
58
+ const perPage = args['per-page'] ? Number(args['per-page']) : 25
59
+ const productId = args['product-id'] || args.product
60
+
61
+ switch (cmd) {
62
+ case 'reviews':
63
+ switch (sub) {
64
+ case 'list': {
65
+ let qs = `?page[size]=${perPage}&page[number]=${page}`
66
+ if (productId) qs += `&filter[product_id]=${productId}`
67
+ if (args.state) qs += `&filter[state]=${encodeURIComponent(args.state)}`
68
+ result = await api('GET', `/survey-responses${qs}`)
69
+ break
70
+ }
71
+ case 'get': {
72
+ const id = args.id
73
+ if (!id) { result = { error: '--id required' }; break }
74
+ result = await api('GET', `/survey-responses/${id}`)
75
+ break
76
+ }
77
+ default:
78
+ result = { error: 'Unknown reviews subcommand. Use: list, get' }
79
+ }
80
+ break
81
+
82
+ case 'products':
83
+ switch (sub) {
84
+ case 'list': {
85
+ let qs = `?page[size]=${perPage}&page[number]=${page}`
86
+ if (args.name) qs += `&filter[name]=${encodeURIComponent(args.name)}`
87
+ result = await api('GET', `/products${qs}`)
88
+ break
89
+ }
90
+ case 'get': {
91
+ const id = args.id
92
+ if (!id) { result = { error: '--id required' }; break }
93
+ result = await api('GET', `/products/${id}`)
94
+ break
95
+ }
96
+ default:
97
+ result = { error: 'Unknown products subcommand. Use: list, get' }
98
+ }
99
+ break
100
+
101
+ case 'reports':
102
+ switch (sub) {
103
+ case 'list': {
104
+ let qs = `?page[size]=${perPage}&page[number]=${page}`
105
+ result = await api('GET', `/reports${qs}`)
106
+ break
107
+ }
108
+ case 'get': {
109
+ const id = args.id
110
+ if (!id) { result = { error: '--id required' }; break }
111
+ result = await api('GET', `/reports/${id}`)
112
+ break
113
+ }
114
+ default:
115
+ result = { error: 'Unknown reports subcommand. Use: list, get' }
116
+ }
117
+ break
118
+
119
+ case 'competitors':
120
+ switch (sub) {
121
+ case 'list': {
122
+ if (!productId) { result = { error: '--product-id required' }; break }
123
+ let qs = `?page[size]=${perPage}&page[number]=${page}&filter[product_id]=${productId}`
124
+ result = await api('GET', `/competitor-comparisons${qs}`)
125
+ break
126
+ }
127
+ default:
128
+ result = { error: 'Unknown competitors subcommand. Use: list' }
129
+ }
130
+ break
131
+
132
+ case 'categories':
133
+ switch (sub) {
134
+ case 'list': {
135
+ let qs = `?page[size]=${perPage}&page[number]=${page}`
136
+ if (args.name) qs += `&filter[name]=${encodeURIComponent(args.name)}`
137
+ result = await api('GET', `/categories${qs}`)
138
+ break
139
+ }
140
+ case 'get': {
141
+ const id = args.id
142
+ if (!id) { result = { error: '--id required' }; break }
143
+ result = await api('GET', `/categories/${id}`)
144
+ break
145
+ }
146
+ default:
147
+ result = { error: 'Unknown categories subcommand. Use: list, get' }
148
+ }
149
+ break
150
+
151
+ case 'tracking':
152
+ switch (sub) {
153
+ case 'visitors': {
154
+ let qs = `?page[size]=${perPage}&page[number]=${page}`
155
+ if (args.start) qs += `&filter[start_date]=${encodeURIComponent(args.start)}`
156
+ if (args.end) qs += `&filter[end_date]=${encodeURIComponent(args.end)}`
157
+ result = await api('GET', `/tracking-events${qs}`)
158
+ break
159
+ }
160
+ default:
161
+ result = { error: 'Unknown tracking subcommand. Use: visitors' }
162
+ }
163
+ break
164
+
165
+ default:
166
+ result = {
167
+ error: 'Unknown command',
168
+ usage: {
169
+ reviews: 'reviews [list --product-id <id> | get --id <id>]',
170
+ products: 'products [list --name <name> | get --id <id>]',
171
+ reports: 'reports [list | get --id <id>]',
172
+ competitors: 'competitors [list --product-id <id>]',
173
+ categories: 'categories [list --name <name> | get --id <id>]',
174
+ tracking: 'tracking [visitors --start <date> --end <date>]',
175
+ options: '--page <n> --per-page <n>',
176
+ }
177
+ }
178
+ }
179
+
180
+ console.log(JSON.stringify(result, null, 2))
181
+ }
182
+
183
+ main().catch(err => {
184
+ console.error(JSON.stringify({ error: err.message }))
185
+ process.exit(1)
186
+ })
@@ -0,0 +1,194 @@
1
+ #!/usr/bin/env node
2
+
3
+ const ACCESS_TOKEN = process.env.GA4_ACCESS_TOKEN
4
+ const DATA_API = 'https://analyticsdata.googleapis.com/v1beta'
5
+ const ADMIN_API = 'https://analyticsadmin.googleapis.com/v1beta'
6
+ const MP_URL = 'https://www.google-analytics.com/mp/collect'
7
+
8
+ if (!ACCESS_TOKEN) {
9
+ console.error(JSON.stringify({ error: 'GA4_ACCESS_TOKEN environment variable required' }))
10
+ process.exit(1)
11
+ }
12
+
13
+ async function api(method, baseUrl, path, body) {
14
+ if (args['dry-run']) {
15
+ return { _dry_run: true, method, url: `${baseUrl}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined }
16
+ }
17
+ const res = await fetch(`${baseUrl}${path}`, {
18
+ method,
19
+ headers: {
20
+ 'Authorization': `Bearer ${ACCESS_TOKEN}`,
21
+ 'Content-Type': 'application/json',
22
+ },
23
+ body: body ? JSON.stringify(body) : undefined,
24
+ })
25
+ const text = await res.text()
26
+ try {
27
+ return JSON.parse(text)
28
+ } catch {
29
+ return { status: res.status, body: text }
30
+ }
31
+ }
32
+
33
+ async function mpApi(measurementId, apiSecret, body) {
34
+ const params = new URLSearchParams({ measurement_id: measurementId, api_secret: apiSecret })
35
+ if (args['dry-run']) {
36
+ return { _dry_run: true, method: 'POST', url: `${MP_URL}?${new URLSearchParams({ measurement_id: measurementId, api_secret: '***' })}`, headers: { 'Content-Type': 'application/json' }, body: body || undefined }
37
+ }
38
+ const res = await fetch(`${MP_URL}?${params}`, {
39
+ method: 'POST',
40
+ headers: { 'Content-Type': 'application/json' },
41
+ body: JSON.stringify(body),
42
+ })
43
+ const text = await res.text()
44
+ if (!text) return { status: res.status, success: res.ok }
45
+ try {
46
+ return JSON.parse(text)
47
+ } catch {
48
+ return { status: res.status, body: text }
49
+ }
50
+ }
51
+
52
+ function parseArgs(args) {
53
+ const result = { _: [] }
54
+ for (let i = 0; i < args.length; i++) {
55
+ const arg = args[i]
56
+ if (arg.startsWith('--')) {
57
+ const key = arg.slice(2)
58
+ const next = args[i + 1]
59
+ if (next && !next.startsWith('--')) {
60
+ result[key] = next
61
+ i++
62
+ } else {
63
+ result[key] = true
64
+ }
65
+ } else {
66
+ result._.push(arg)
67
+ }
68
+ }
69
+ return result
70
+ }
71
+
72
+ const args = parseArgs(process.argv.slice(2))
73
+ const [cmd, sub, ...rest] = args._
74
+
75
+ async function main() {
76
+ let result
77
+
78
+ switch (cmd) {
79
+ case 'reports':
80
+ switch (sub) {
81
+ case 'run': {
82
+ const property = args.property
83
+ if (!property) { result = { error: '--property required' }; break }
84
+ const body = {
85
+ dateRanges: [{
86
+ startDate: args['start-date'] || '30daysAgo',
87
+ endDate: args['end-date'] || 'today',
88
+ }],
89
+ }
90
+ if (args.dimensions) {
91
+ body.dimensions = args.dimensions.split(',').map(d => ({ name: d.trim() }))
92
+ }
93
+ if (args.metrics) {
94
+ body.metrics = args.metrics.split(',').map(m => ({ name: m.trim() }))
95
+ }
96
+ result = await api('POST', DATA_API, `/properties/${property}:runReport`, body)
97
+ break
98
+ }
99
+ default:
100
+ result = { error: 'Unknown reports subcommand. Use: run' }
101
+ }
102
+ break
103
+
104
+ case 'realtime':
105
+ switch (sub) {
106
+ case 'run': {
107
+ const property = args.property
108
+ if (!property) { result = { error: '--property required' }; break }
109
+ const body = {}
110
+ if (args.dimensions) {
111
+ body.dimensions = args.dimensions.split(',').map(d => ({ name: d.trim() }))
112
+ }
113
+ if (args.metrics) {
114
+ body.metrics = args.metrics.split(',').map(m => ({ name: m.trim() }))
115
+ }
116
+ result = await api('POST', DATA_API, `/properties/${property}:runRealtimeReport`, body)
117
+ break
118
+ }
119
+ default:
120
+ result = { error: 'Unknown realtime subcommand. Use: run' }
121
+ }
122
+ break
123
+
124
+ case 'conversions':
125
+ switch (sub) {
126
+ case 'list': {
127
+ const property = args.property
128
+ if (!property) { result = { error: '--property required' }; break }
129
+ result = await api('GET', ADMIN_API, `/properties/${property}/conversionEvents`)
130
+ break
131
+ }
132
+ case 'create': {
133
+ const property = args.property
134
+ if (!property) { result = { error: '--property required' }; break }
135
+ if (!args['event-name']) { result = { error: '--event-name required' }; break }
136
+ result = await api('POST', ADMIN_API, `/properties/${property}/conversionEvents`, {
137
+ eventName: args['event-name'],
138
+ })
139
+ break
140
+ }
141
+ default:
142
+ result = { error: 'Unknown conversions subcommand. Use: list, create' }
143
+ }
144
+ break
145
+
146
+ case 'events':
147
+ switch (sub) {
148
+ case 'send': {
149
+ if (!args['measurement-id']) { result = { error: '--measurement-id required' }; break }
150
+ if (!args['api-secret']) { result = { error: '--api-secret required' }; break }
151
+ if (!args['client-id']) { result = { error: '--client-id required' }; break }
152
+ if (!args['event-name']) { result = { error: '--event-name required' }; break }
153
+ let eventParams = {}
154
+ if (args.params) {
155
+ try {
156
+ eventParams = JSON.parse(args.params)
157
+ } catch {
158
+ result = { error: 'Invalid JSON in --params' }; break
159
+ }
160
+ }
161
+ const body = {
162
+ client_id: args['client-id'],
163
+ events: [{
164
+ name: args['event-name'],
165
+ params: eventParams,
166
+ }],
167
+ }
168
+ result = await mpApi(args['measurement-id'], args['api-secret'], body)
169
+ break
170
+ }
171
+ default:
172
+ result = { error: 'Unknown events subcommand. Use: send' }
173
+ }
174
+ break
175
+
176
+ default:
177
+ result = {
178
+ error: 'Unknown command',
179
+ usage: {
180
+ reports: 'reports run --property <id> [--start-date <date>] [--end-date <date>] [--dimensions <dims>] [--metrics <metrics>]',
181
+ realtime: 'realtime run --property <id> [--dimensions <dims>] [--metrics <metrics>]',
182
+ conversions: 'conversions [list|create] --property <id> [--event-name <name>]',
183
+ events: 'events send --measurement-id <id> --api-secret <secret> --client-id <id> --event-name <name> [--params <json>]',
184
+ }
185
+ }
186
+ }
187
+
188
+ console.log(JSON.stringify(result, null, 2))
189
+ }
190
+
191
+ main().catch(err => {
192
+ console.error(JSON.stringify({ error: err.message }))
193
+ process.exit(1)
194
+ })