@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 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 synced local mirror with read-only SQL - free; bare `sql` prints compact schema metadata. | |
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 synced local mirror with read-only SQL - free; bare `sql` prints compact schema metadata. | |
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 --limit 20 | jq '{cost: .meta.cost, cursor: .meta.cursor, cache: .meta.cache}'
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