deso-ag 1.0.2 → 1.0.3
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 +26 -26
- package/dist/index.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -52,16 +52,16 @@ Without a key, the respective source/feature is skipped and everything else stil
|
|
|
52
52
|
Search for posts across networks.
|
|
53
53
|
|
|
54
54
|
```bash
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
55
|
+
deso-ag search "ethereum"
|
|
56
|
+
deso-ag search "AI" --sources nostr
|
|
57
|
+
deso-ag search --channel dev --sources farcaster
|
|
58
58
|
```
|
|
59
59
|
|
|
60
60
|
Multi-word queries use AND semantics (all terms must match):
|
|
61
61
|
|
|
62
62
|
```bash
|
|
63
|
-
|
|
64
|
-
|
|
63
|
+
deso-ag search "AI crypto" # posts must contain both "AI" and "crypto"
|
|
64
|
+
deso-ag search "ethereum layer2"
|
|
65
65
|
```
|
|
66
66
|
|
|
67
67
|
### `trending`
|
|
@@ -69,9 +69,9 @@ pnpm dev search "ethereum layer2"
|
|
|
69
69
|
Get trending posts from all networks.
|
|
70
70
|
|
|
71
71
|
```bash
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
72
|
+
deso-ag trending
|
|
73
|
+
deso-ag trending --sources farcaster,lens
|
|
74
|
+
deso-ag trending --format json --limit 50
|
|
75
75
|
```
|
|
76
76
|
|
|
77
77
|
### `terms`
|
|
@@ -79,9 +79,9 @@ pnpm dev trending --format json --limit 50
|
|
|
79
79
|
Extract top discussion terms from posts via engagement-weighted frequency analysis.
|
|
80
80
|
|
|
81
81
|
```bash
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
82
|
+
deso-ag terms # top 3 terms per platform, last 24h
|
|
83
|
+
deso-ag terms -n 5 -s farcaster -t week # top 5, Farcaster only, last week
|
|
84
|
+
deso-ag terms -f json # machine-readable output
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
### `channels`
|
|
@@ -89,8 +89,8 @@ pnpm dev terms -f json # machine-readable output
|
|
|
89
89
|
Browse popular Farcaster channels.
|
|
90
90
|
|
|
91
91
|
```bash
|
|
92
|
-
|
|
93
|
-
|
|
92
|
+
deso-ag channels
|
|
93
|
+
deso-ag channels --limit 50
|
|
94
94
|
```
|
|
95
95
|
|
|
96
96
|
## Options
|
|
@@ -129,8 +129,8 @@ deso-ag is designed for consumption by AI agents doing research across decentral
|
|
|
129
129
|
The `compact` format returns a single JSON object with a metadata envelope, pre-computed engagement scores, full untruncated content, and source health info:
|
|
130
130
|
|
|
131
131
|
```bash
|
|
132
|
-
|
|
133
|
-
|
|
132
|
+
deso-ag trending -f compact -l 10
|
|
133
|
+
deso-ag search "AI agents" -f compact -l 10
|
|
134
134
|
```
|
|
135
135
|
|
|
136
136
|
Output shape:
|
|
@@ -211,37 +211,37 @@ import { fetchFarcaster, fetchLens, fetchNostr, fetchBluesky, computeEngagementS
|
|
|
211
211
|
|
|
212
212
|
```bash
|
|
213
213
|
# Get a quick summary of trending content
|
|
214
|
-
|
|
214
|
+
deso-ag trending -f summary -l 20
|
|
215
215
|
|
|
216
216
|
# Agent-optimized compact output sorted by engagement
|
|
217
|
-
|
|
217
|
+
deso-ag trending -f compact -o engagement -l 10
|
|
218
218
|
|
|
219
219
|
# Search for AI discussions on Lens only
|
|
220
|
-
|
|
220
|
+
deso-ag search "AI" -s lens -f json
|
|
221
221
|
|
|
222
222
|
# Multi-word search with compact output
|
|
223
|
-
|
|
223
|
+
deso-ag search "AI crypto" -f compact -l 10
|
|
224
224
|
|
|
225
225
|
# Browse the /dev channel on Farcaster
|
|
226
|
-
|
|
226
|
+
deso-ag search --channel dev -s farcaster
|
|
227
227
|
|
|
228
228
|
# Export trending Nostr posts as JSON
|
|
229
|
-
|
|
229
|
+
deso-ag trending -s nostr -f json > nostr-trending.json
|
|
230
230
|
|
|
231
231
|
# Search Bluesky for discussions
|
|
232
|
-
|
|
232
|
+
deso-ag search "ethereum" -s bluesky -l 5
|
|
233
233
|
|
|
234
234
|
# Trending on Bluesky
|
|
235
|
-
|
|
235
|
+
deso-ag trending -s bluesky -f summary
|
|
236
236
|
|
|
237
237
|
# Sort search results by recency
|
|
238
|
-
|
|
238
|
+
deso-ag search "ethereum" -o recent -f json -l 5
|
|
239
239
|
|
|
240
240
|
# Top 5 terms across all networks this week
|
|
241
|
-
|
|
241
|
+
deso-ag terms -n 5 -t week
|
|
242
242
|
|
|
243
243
|
# Terms from Farcaster and Nostr as JSON
|
|
244
|
-
|
|
244
|
+
deso-ag terms -f json -s farcaster,nostr -l 10
|
|
245
245
|
```
|
|
246
246
|
|
|
247
247
|
## Supported Networks
|
package/dist/index.js
CHANGED
|
@@ -13,7 +13,7 @@ const program = new Command();
|
|
|
13
13
|
program
|
|
14
14
|
.name('deso-ag')
|
|
15
15
|
.description('CLI tool for aggregating posts from decentralized social protocols')
|
|
16
|
-
.version('1.0.
|
|
16
|
+
.version('1.0.3');
|
|
17
17
|
program
|
|
18
18
|
.command('search [query]')
|
|
19
19
|
.description('Search for posts across decentralized social networks')
|