@usesocial/cli 0.9.0 → 0.10.1
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/CHANGELOG.md +12 -0
- package/README.md +27 -8
- package/dist/index.mjs +491 -138
- package/dist/index.mjs.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# @usesocial/cli
|
|
2
2
|
|
|
3
|
+
## 0.10.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [#39](https://github.com/usesocial/monorepo/pull/39) [`1251f10`](https://github.com/usesocial/monorepo/commit/1251f10ec78b759109cd40f159b9933be7326133) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Add LinkedIn company Page analytics, Page invite, and raw proxy commands.
|
|
8
|
+
|
|
9
|
+
## 0.10.0
|
|
10
|
+
|
|
11
|
+
### Minor Changes
|
|
12
|
+
|
|
13
|
+
- [#38](https://github.com/usesocial/monorepo/pull/38) [`9f1f30d`](https://github.com/usesocial/monorepo/commit/9f1f30daeb89b5ad83bcc456a0ed71a5587e790c) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Add `social x sync timeline` for syncing the authenticated X home timeline into the local SQL mirror, remove the live `social x timeline` shortcut from the public command surface, and let local SQL reads query partial mirror rows.
|
|
14
|
+
|
|
3
15
|
## 0.9.0
|
|
4
16
|
|
|
5
17
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -48,8 +48,9 @@ social x profile
|
|
|
48
48
|
| "Surface the ten warm contacts worth reaching out to this week." | `linkedin search people`, `linkedin reactions`, `linkedin sql` |
|
|
49
49
|
| "Pull everyone who reacted to my last LinkedIn post and flag the warm leads." | `linkedin posts <target>`, `linkedin reactions`, `linkedin profile` |
|
|
50
50
|
| "Read this creator's recent posts and break down what makes them land." | `linkedin posts <target>`, `x tweets <target>` |
|
|
51
|
-
| "Find what people are saying about AI agents this week and summarize the themes." | `linkedin search posts`, `x timeline` |
|
|
51
|
+
| "Find what people are saying about AI agents this week and summarize the themes." | `linkedin search posts`, `x sync timeline`, `x sql` |
|
|
52
52
|
| "Triage my inbox and draft replies for approval." | `sync messages`, `sql`, `linkedin message`, `x message` |
|
|
53
|
+
| "Show this week's company Page visitors and invite the approved prospects." | `linkedin page visitors`, `linkedin page invite` |
|
|
53
54
|
| "Draft a reply to this thread and post it once I approve." | `linkedin comment`, `x post` |
|
|
54
55
|
|
|
55
56
|
## Commands
|
|
@@ -78,7 +79,12 @@ social linkedin post < draft.md
|
|
|
78
79
|
social linkedin requests send @username < note.txt
|
|
79
80
|
```
|
|
80
81
|
|
|
81
|
-
Pipe a JSON object for advanced payload fields.
|
|
82
|
+
Pipe a JSON object for advanced payload fields. Raw LinkedIn proxy calls also
|
|
83
|
+
read a JSON envelope from stdin:
|
|
84
|
+
|
|
85
|
+
```sh
|
|
86
|
+
social linkedin proxy < request.json
|
|
87
|
+
```
|
|
82
88
|
|
|
83
89
|
### Pagination
|
|
84
90
|
|
|
@@ -146,6 +152,8 @@ profile lookup is needed.
|
|
|
146
152
|
| `billing portal` | Open the hosted billing portal and print its URL. | |
|
|
147
153
|
| `usage` | Aggregate proxy calls and credits. | |
|
|
148
154
|
| `logs` | Recent proxy calls. | |
|
|
155
|
+
| `config account` | Read or set the default connected account selector. | local |
|
|
156
|
+
| `config page` | Read or set the default LinkedIn company Page selector. | local |
|
|
149
157
|
| `config cache ttl` | Read or set the live-read proxy cache TTL in seconds. | |
|
|
150
158
|
|
|
151
159
|
### `social linkedin`
|
|
@@ -160,8 +168,11 @@ profile lookup is needed.
|
|
|
160
168
|
| `company <target>` | Fetch a company profile. | |
|
|
161
169
|
| `jobs <target>` | List a company's job postings. | |
|
|
162
170
|
| `search people\|posts\|jobs\|companies <keywords>` | Search LinkedIn. | |
|
|
171
|
+
| `page visitors` | Read company Page visitor analytics; pass `--page` or configure a default Page. Costs credits. | |
|
|
172
|
+
| `page invite <user...>` | Invite one or more users to follow the company Page selected by `--page` or default config. | write |
|
|
173
|
+
| `proxy` | Forward a raw LinkedIn JSON envelope from stdin via Unipile. | write |
|
|
163
174
|
| `sync [collection]` | Pull your own `connections`, `posts`, `messages`, or `requests` into the local mirror; costs credits. | local |
|
|
164
|
-
| `sql [query]` | Query your
|
|
175
|
+
| `sql [query]` | Query your local mirror with read-only SQL - free; bare `sql` prints compact schema metadata. | |
|
|
165
176
|
| `post` | Create a post (body from stdin). | write |
|
|
166
177
|
| `comment <target>` | Comment on a post (body from stdin). | write |
|
|
167
178
|
| `react <target>` | React to a post; use `--type` for non-like reactions. | write |
|
|
@@ -180,7 +191,6 @@ profile lookup is needed.
|
|
|
180
191
|
| --- | --- | --- |
|
|
181
192
|
| `profile [target]` | Fetch a profile; omit target for your own account. | |
|
|
182
193
|
| `tweets <target>` | Live posts for a user; target required. | |
|
|
183
|
-
| `timeline` | Read the home timeline. | |
|
|
184
194
|
| `mentions [target]` | List posts mentioning a user; omit target for your own account. | |
|
|
185
195
|
| `liked [target]` | List posts a user liked; omit target for your own account. | |
|
|
186
196
|
| `followers [target]` | Live follower graph read; omit target for your own account. Costs credits. | |
|
|
@@ -190,8 +200,8 @@ profile lookup is needed.
|
|
|
190
200
|
| `quotes <target>` | List quote posts of a post. | |
|
|
191
201
|
| `likers <target>` | List users who liked a post. | |
|
|
192
202
|
| `reposters <target>` | List users who reposted a post. | |
|
|
193
|
-
| `sync [collection]` | Pull your own `tweets`, `followers`, `following`, `bookmarks`, or `messages` into the local mirror; costs credits. | local |
|
|
194
|
-
| `sql [query]` | Query your
|
|
203
|
+
| `sync [collection]` | Pull your own `tweets`, `timeline`, `followers`, `following`, `bookmarks`, `liked`, `mentions`, or `messages` into the local mirror; costs credits. | local |
|
|
204
|
+
| `sql [query]` | Query your local mirror with read-only SQL - free; bare `sql` prints compact schema metadata. | |
|
|
195
205
|
| `post` | Create a post (body from stdin). | write |
|
|
196
206
|
| `message <recipients>` | Send a DM (body from stdin). | write |
|
|
197
207
|
| `like <target>` / `unlike <target>` | Like or unlike a post. | write |
|
|
@@ -276,7 +286,9 @@ query it with `sql`. SQL reads show local freshness in `meta.cache.tables` and a
|
|
|
276
286
|
```sh
|
|
277
287
|
social x sql "SELECT sender_username, text FROM x_messages ORDER BY created_at DESC LIMIT 5" \
|
|
278
288
|
| jq '{cost: .meta.cost, cache: .meta.cache}'
|
|
279
|
-
social x timeline
|
|
289
|
+
social x sync timeline
|
|
290
|
+
social x sql "SELECT text, url FROM x_timeline ORDER BY created_at DESC LIMIT 20" \
|
|
291
|
+
| jq '{cost: .meta.cost, cache: .meta.cache}'
|
|
280
292
|
```
|
|
281
293
|
|
|
282
294
|
Agents should watch `.meta.cost` during high-fanout loops, use
|
|
@@ -293,6 +305,7 @@ social linkedin sql "SELECT user_name, user_username FROM li_requests WHERE type
|
|
|
293
305
|
|
|
294
306
|
# LinkedIn live reads.
|
|
295
307
|
social linkedin profile
|
|
308
|
+
social linkedin page visitors --page company_id:<company-id> --since 2026-05-01T00:00:00Z
|
|
296
309
|
PAGE1=$(social linkedin posts profile_id:<profile-id> --limit 25)
|
|
297
310
|
NEXT=$(echo "$PAGE1" | jq -r '.meta.cursor // empty')
|
|
298
311
|
[ -n "$NEXT" ] && social linkedin posts profile_id:<profile-id> --limit 25 --cursor "$NEXT"
|
|
@@ -303,17 +316,23 @@ social x sync messages
|
|
|
303
316
|
social x sql "SELECT sender_username, text FROM x_messages ORDER BY created_at DESC LIMIT 20"
|
|
304
317
|
social x sql "SELECT text, url FROM x_bookmarks ORDER BY created_at DESC LIMIT 50"
|
|
305
318
|
social x sql "SELECT username, name, followers_count FROM x_followers ORDER BY followers_count DESC LIMIT 100"
|
|
319
|
+
social x sync timeline
|
|
320
|
+
social x sql "SELECT text, url FROM x_timeline ORDER BY created_at DESC LIMIT 50"
|
|
306
321
|
|
|
307
322
|
# X live reads.
|
|
308
323
|
social x tweets profile_id:<x-user-id> --limit 30
|
|
309
324
|
social x replies post_id:<post-id> --limit 25
|
|
310
|
-
social x timeline --limit 50
|
|
311
325
|
|
|
312
326
|
# Writes (body via stdin).
|
|
313
327
|
echo "gm" | social x post
|
|
314
328
|
social linkedin post < draft.md
|
|
329
|
+
social linkedin page invite profile_id:<profile-id> @username --page company_id:<company-id>
|
|
315
330
|
echo "Loved your launch notes." | social linkedin requests send profile_id:<profile-id>
|
|
316
331
|
|
|
332
|
+
# LinkedIn raw proxy.
|
|
333
|
+
social account config page company_id:<company-id>
|
|
334
|
+
social linkedin proxy < request.json
|
|
335
|
+
|
|
317
336
|
# Usage / billing.
|
|
318
337
|
social account billing
|
|
319
338
|
social account billing portal
|