trendsagi 0.17.0 → 0.19.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.
- package/README.md +7 -1
- package/cli_spec.json +125 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -19,6 +19,11 @@ trendsagi --help
|
|
|
19
19
|
```bash
|
|
20
20
|
trendsagi trends list --sort velocity --limit 10 # fastest-moving topics
|
|
21
21
|
trendsagi trends analytics 123 --period 7d # one trend's readings over time
|
|
22
|
+
trendsagi trends dossier 123 # source-backed story, timeline and channels
|
|
23
|
+
trendsagi trends enrich 123 --module search_demand # on-demand Deep Dive (can reserve credits)
|
|
24
|
+
trendsagi trends social-evidence get 123 # stored post-level evidence
|
|
25
|
+
trendsagi trends social-evidence run 123 --module posts # refresh it (reserves one credit)
|
|
26
|
+
trendsagi credits social-evidence # balance and one-time packs
|
|
22
27
|
trendsagi insights get 123 # audience, sentiment and marketing angles
|
|
23
28
|
trendsagi insights generate 123 --wait # build fresh insights, then print them
|
|
24
29
|
trendsagi recommendations list --priority high # prioritised actions with their evidence
|
|
@@ -35,7 +40,8 @@ trendsagi api /api/integrations/delivery/health -q lookback_hours=24 # any end
|
|
|
35
40
|
| Commands | What they do |
|
|
36
41
|
| --- | --- |
|
|
37
42
|
| `login`, `logout`, `whoami` | Save, forget and check the API key |
|
|
38
|
-
| `trends` | Trending topics: `list`, `get`, `analytics`, `categories`, `autocomplete` |
|
|
43
|
+
| `trends` | Trending topics: `list`, `get`, `analytics`, `categories`, `autocomplete`, `dossier`, `discoveries`, `enrich`, `search-demand`, `brand-momentum`, `creators`, `ask`, `social-evidence get\|run` |
|
|
44
|
+
| `credits` | `social-evidence` balance, `buy-social-evidence` checkout |
|
|
39
45
|
| `insights` | AI insights: `get`, `generate`, `status`, `search` |
|
|
40
46
|
| `recommendations` (`recs`) | `list`, `action`, `feedback` |
|
|
41
47
|
| `crisis` | `list`, `action` (acknowledge, archive, reopen) |
|
package/cli_spec.json
CHANGED
|
@@ -78,6 +78,131 @@
|
|
|
78
78
|
"method": "GET",
|
|
79
79
|
"path": "/api/trends/autocomplete",
|
|
80
80
|
"args": [{"name": "query", "param": "q", "in": "query", "help": "Phrase to complete."}]
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"name": "dossier",
|
|
84
|
+
"help": "Show the source-backed dossier for a trend.",
|
|
85
|
+
"method": "GET",
|
|
86
|
+
"path": "/api/trends/{trend_id}/dossier",
|
|
87
|
+
"args": [{"name": "trend_id", "type": "int", "help": "Trend ID."}],
|
|
88
|
+
"table": {"kind": "object"}
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
"name": "discoveries",
|
|
92
|
+
"help": "List labels found in an external trend list (discovery evidence, not measurements).",
|
|
93
|
+
"method": "GET",
|
|
94
|
+
"path": "/api/trends/discoveries",
|
|
95
|
+
"options": [
|
|
96
|
+
{"flag": "limit", "type": "int", "default": 50, "help": "Rows to return, 1-200."}
|
|
97
|
+
],
|
|
98
|
+
"table": {"rows": "discoveries", "columns": ["label", "rank", "source", "region", "matched_trend_id"]}
|
|
99
|
+
},
|
|
100
|
+
{
|
|
101
|
+
"name": "enrich",
|
|
102
|
+
"help": "Run an on-demand Deep Dive (search demand, ads or creators). Can reserve credits.",
|
|
103
|
+
"method": "POST",
|
|
104
|
+
"path": "/api/trends/{trend_id}/enrich",
|
|
105
|
+
"args": [{"name": "trend_id", "type": "int", "help": "Trend ID."}],
|
|
106
|
+
"options": [
|
|
107
|
+
{"flag": "module", "param": "modules", "type": "list", "metavar": "A,B", "help": "Modules to build: search_demand,ads,creators."},
|
|
108
|
+
{"flag": "region", "default": "US", "help": "Two-letter market code."},
|
|
109
|
+
{"flag": "force", "type": "flag", "help": "Rebuild a cached module."},
|
|
110
|
+
{"flag": "request-id", "param": "request_id", "help": "Idempotency key for the credit reservation."}
|
|
111
|
+
],
|
|
112
|
+
"confirm": "Run a Deep Dive for trend {trend_id}? It can reserve credits.",
|
|
113
|
+
"table": {"kind": "object"}
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
"name": "search-demand",
|
|
117
|
+
"help": "Show the stored relative search-interest series and related queries.",
|
|
118
|
+
"method": "GET",
|
|
119
|
+
"path": "/api/trends/{trend_id}/search-demand",
|
|
120
|
+
"args": [{"name": "trend_id", "type": "int", "help": "Trend ID."}],
|
|
121
|
+
"options": [{"flag": "geo", "default": "US", "help": "Two-letter market code."}],
|
|
122
|
+
"table": {"rows": "series", "columns": ["captured_at", "interest"]}
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"name": "brand-momentum",
|
|
126
|
+
"help": "Show the brands visible in a trend's coverage and their movement.",
|
|
127
|
+
"method": "GET",
|
|
128
|
+
"path": "/api/trends/{trend_id}/brand-momentum",
|
|
129
|
+
"args": [{"name": "trend_id", "type": "int", "help": "Trend ID."}],
|
|
130
|
+
"options": [{"flag": "window", "choices": ["24h", "7d", "30d"], "default": "7d", "help": "Comparison window."}],
|
|
131
|
+
"table": {"rows": "brands", "columns": ["name", "mentions", "share", "sentiment", "delta"]}
|
|
132
|
+
},
|
|
133
|
+
{
|
|
134
|
+
"name": "creators",
|
|
135
|
+
"help": "List the accounts posting most about a trend.",
|
|
136
|
+
"method": "GET",
|
|
137
|
+
"path": "/api/trends/{trend_id}/creators",
|
|
138
|
+
"args": [{"name": "trend_id", "type": "int", "help": "Trend ID."}],
|
|
139
|
+
"table": {"rows": "creators", "columns": ["screen_name", "followers_count", "posts", "profile_url"]}
|
|
140
|
+
},
|
|
141
|
+
{
|
|
142
|
+
"name": "ask",
|
|
143
|
+
"help": "Ask a grounded question about one trend.",
|
|
144
|
+
"method": "POST",
|
|
145
|
+
"path": "/api/trends/{trend_id}/ask",
|
|
146
|
+
"args": [
|
|
147
|
+
{"name": "trend_id", "type": "int", "help": "Trend ID."},
|
|
148
|
+
{"name": "question", "in": "body", "help": "Question about the trend."}
|
|
149
|
+
],
|
|
150
|
+
"table": {"kind": "object"}
|
|
151
|
+
},
|
|
152
|
+
{
|
|
153
|
+
"name": "social-evidence",
|
|
154
|
+
"help": "Read or run Social Evidence for a trend.",
|
|
155
|
+
"commands": [
|
|
156
|
+
{
|
|
157
|
+
"name": "get",
|
|
158
|
+
"help": "Show the stored Social Evidence report (free).",
|
|
159
|
+
"method": "GET",
|
|
160
|
+
"path": "/api/trends/{trend_id}/social-evidence",
|
|
161
|
+
"args": [{"name": "trend_id", "type": "int", "help": "Trend ID."}],
|
|
162
|
+
"table": {"kind": "object"}
|
|
163
|
+
},
|
|
164
|
+
{
|
|
165
|
+
"name": "run",
|
|
166
|
+
"help": "Run or refresh Social Evidence (reserves one credit).",
|
|
167
|
+
"method": "POST",
|
|
168
|
+
"path": "/api/trends/{trend_id}/social-evidence",
|
|
169
|
+
"args": [{"name": "trend_id", "type": "int", "help": "Trend ID."}],
|
|
170
|
+
"options": [
|
|
171
|
+
{"flag": "module", "param": "modules", "type": "list", "metavar": "A,B", "help": "Modules: posts,transcripts,creators,comments,ads,sponsors,hashtags,mentions."},
|
|
172
|
+
{"flag": "region", "default": "US", "help": "Two-letter market code."},
|
|
173
|
+
{"flag": "force", "type": "flag", "help": "Rebuild the report."},
|
|
174
|
+
{"flag": "request-id", "param": "request_id", "help": "Idempotency key for the credit reservation."}
|
|
175
|
+
],
|
|
176
|
+
"confirm": "Run Social Evidence for trend {trend_id}? It reserves one credit.",
|
|
177
|
+
"table": {"kind": "object"}
|
|
178
|
+
}
|
|
179
|
+
]
|
|
180
|
+
}
|
|
181
|
+
]
|
|
182
|
+
},
|
|
183
|
+
{
|
|
184
|
+
"name": "credits",
|
|
185
|
+
"help": "Credit balances and one-time packs.",
|
|
186
|
+
"commands": [
|
|
187
|
+
{
|
|
188
|
+
"name": "social-evidence",
|
|
189
|
+
"help": "Show the Social Evidence credit balance.",
|
|
190
|
+
"method": "GET",
|
|
191
|
+
"path": "/api/user/social-evidence-credits",
|
|
192
|
+
"table": {"kind": "object"}
|
|
193
|
+
},
|
|
194
|
+
{
|
|
195
|
+
"name": "buy-social-evidence",
|
|
196
|
+
"help": "Create a Stripe Checkout session for a Social Evidence pack.",
|
|
197
|
+
"method": "POST",
|
|
198
|
+
"path": "/api/billing/social-evidence/checkout",
|
|
199
|
+
"args": [{"name": "pack_id", "in": "body", "help": "Pack ID from 'credits social-evidence'."}],
|
|
200
|
+
"options": [
|
|
201
|
+
{"flag": "success-url", "param": "success_url", "help": "Return URL after payment."},
|
|
202
|
+
{"flag": "cancel-url", "param": "cancel_url", "help": "Return URL after cancellation."}
|
|
203
|
+
],
|
|
204
|
+
"confirm": "Create a checkout session for pack {pack_id}?",
|
|
205
|
+
"table": {"kind": "object"}
|
|
81
206
|
}
|
|
82
207
|
]
|
|
83
208
|
},
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "trendsagi",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.19.0",
|
|
4
4
|
"description": "TrendsAGI CLI: real-time trending topics with measured volume, velocity and growth, AI insights, recommendations, crisis alerts and read-only SQL from your terminal. For paid media, growth and AI agent workflows.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"trendsagi",
|