askaipods 0.2.3 → 0.2.4
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 +4 -4
- package/examples/claude-code-install.md +1 -1
- package/package.json +1 -1
- package/skill/askaipods/SKILL.md +3 -3
- package/src/cli.js +3 -3
- package/src/client.js +5 -5
- package/src/format.js +1 -1
package/README.md
CHANGED
|
@@ -7,7 +7,7 @@ $ askaipods "what are people saying about test-time compute"
|
|
|
7
7
|
|
|
8
8
|
# askaipods · "what are people saying about test-time compute"
|
|
9
9
|
|
|
10
|
-
*Tier: anonymous · Results: 20 · Quota: 1/
|
|
10
|
+
*Tier: anonymous · Results: 20 · Quota: 1/20 daily*
|
|
11
11
|
|
|
12
12
|
## Results — newest first
|
|
13
13
|
|
|
@@ -83,7 +83,7 @@ askaipods "Anthropic safety research" --format json
|
|
|
83
83
|
# Restrict to recent episodes only (anonymous tier caps --days at 90; member tier accepts any value)
|
|
84
84
|
askaipods "GPU shortage" --days 90
|
|
85
85
|
|
|
86
|
-
# Use a member-tier API key for
|
|
86
|
+
# Use a member-tier API key for 100/day instead of 20/day
|
|
87
87
|
ASKAIPODS_API_KEY=pk_xxx askaipods "your query"
|
|
88
88
|
askaipods "your query" --api-key pk_xxx
|
|
89
89
|
```
|
|
@@ -100,7 +100,7 @@ Your agent will recognize the trigger phrase, invoke `askaipods`, and present th
|
|
|
100
100
|
|
|
101
101
|
| | Anonymous (default) | Member |
|
|
102
102
|
|---|---|---|
|
|
103
|
-
| **Daily quota** |
|
|
103
|
+
| **Daily quota** | 20 searches per IP | 100 searches per user |
|
|
104
104
|
| **Results returned** | 20 (deterministic top 20, sorted newest-first) | 20 (deterministic top 20, sorted by relevance) |
|
|
105
105
|
| **Text length** | Full text | Full text |
|
|
106
106
|
| **Date precision** | Month only (`2025-10`) | Full date (`2025-10-15`) |
|
|
@@ -108,7 +108,7 @@ Your agent will recognize the trigger phrase, invoke `askaipods`, and present th
|
|
|
108
108
|
| **Setup** | Nothing | `ASKAIPODS_API_KEY` env var |
|
|
109
109
|
| **Sign up** | n/a | https://podlens.net |
|
|
110
110
|
|
|
111
|
-
The anonymous tier exists so you can try the skill end-to-end with zero setup. Sign up for member access only when you outgrow the
|
|
111
|
+
The anonymous tier exists so you can try the skill end-to-end with zero setup. Sign up for member access only when you outgrow the 20/day quota or need full dates and unlimited lookback.
|
|
112
112
|
|
|
113
113
|
## Honest limitations
|
|
114
114
|
|
|
@@ -45,7 +45,7 @@ Claude Code should recognize the trigger phrase, run `npx askaipods search "..."
|
|
|
45
45
|
|
|
46
46
|
- **Skill not appearing**: Make sure the parent directory name matches the `name` field in `SKILL.md` (both must be `askaipods`).
|
|
47
47
|
- **`npx askaipods` fails**: Check that Node.js 18.3.0+ is installed: `node --version`. The CLI uses zero dependencies so there are no other prereqs.
|
|
48
|
-
- **Anonymous quota exhausted**: Sign up at https://podlens.net for
|
|
48
|
+
- **Anonymous quota exhausted**: Sign up at https://podlens.net for 100/day, then `export ASKAIPODS_API_KEY=pk_xxx`.
|
|
49
49
|
- **Skill triggers too rarely**: Front-load your prompt with the trigger phrases in `SKILL.md` description, or invoke directly with `/askaipods <query>`.
|
|
50
50
|
|
|
51
51
|
## Reference
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "askaipods",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.4",
|
|
4
4
|
"description": "Search AI podcast quotes by topic — recent episode excerpts from Lex Fridman, Dwarkesh Patel, No Priors, Latent Space, and dozens more. Universal agentskills.io skill compatible with Claude Code, OpenAI Codex, Hermes Agent, OpenClaw, and any other agent that supports the open skill standard. Powered by podlens.net.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
package/skill/askaipods/SKILL.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
name: askaipods
|
|
3
3
|
description: Search AI podcast quotes about a topic. Use whenever the user asks "what are people saying about X", "latest takes on Y", "find AI podcast quotes about Z", "who is discussing <model/concept>", or wants to know how AI researchers, founders, or VCs are publicly discussing any AI topic — even when they don't say "podcast". Returns recent excerpts from real episodes of Lex Fridman, Dwarkesh Patel, No Priors, Latent Space, and dozens more, sorted newest-first via the podlens.net semantic search API. Trigger eagerly on AI-research, ML-engineering, AI-investing, or AI-policy questions where real-human commentary beats a web search summary. Do not use for general web search, full transcript reading, or non-AI topics.
|
|
4
4
|
license: MIT
|
|
5
|
-
requirements: Node.js 18.3.0+ on PATH (the CLI uses `node:util.parseArgs`, which was added in 18.3.0), internet access to podlens.net. Optional ASKAIPODS_API_KEY env var unlocks the
|
|
5
|
+
requirements: Node.js 18.3.0+ on PATH (the CLI uses `node:util.parseArgs`, which was added in 18.3.0), internet access to podlens.net. Optional ASKAIPODS_API_KEY env var unlocks the 100/day member tier with full dates and unlimited lookback; without it the skill works on the 20/day anonymous tier (per-IP, month-precision dates, `--days` capped at 90 when specified).
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# askaipods — AI podcast quote search
|
|
@@ -96,7 +96,7 @@ Do NOT silently default every query to `--days 90` — omitting `--days` on broa
|
|
|
96
96
|
],
|
|
97
97
|
"meta": {
|
|
98
98
|
"total_returned": 20,
|
|
99
|
-
"quota": { "used": 3, "limit":
|
|
99
|
+
"quota": { "used": 3, "limit": 100, "period": "daily" },
|
|
100
100
|
"restrictions": null,
|
|
101
101
|
"query_hash": "...",
|
|
102
102
|
"window": { "requested_days": 7, "served_days": 30, "expanded": true, "reason_code": "expanded_on_empty_window" }
|
|
@@ -174,7 +174,7 @@ If the same result appears in both Latest and Top Relevant sections, that's fine
|
|
|
174
174
|
|
|
175
175
|
---
|
|
176
176
|
|
|
177
|
-
*Anonymous tier: 20 results sorted newest-first, dates fuzzed to month, `--days` capped at 90 when specified. Set `ASKAIPODS_API_KEY` for
|
|
177
|
+
*Anonymous tier: 20 results sorted newest-first, dates fuzzed to month, `--days` capped at 90 when specified. Set `ASKAIPODS_API_KEY` for 100 searches/day with full dates and unlimited lookback — sign up at https://podlens.net.*
|
|
178
178
|
```
|
|
179
179
|
|
|
180
180
|
The closing note about the anonymous tier matters because it tells the user (a) why the dates are coarse, (b) what the lookback cap is, and (c) what the upgrade path is. Skipping it leaves the user wondering why dates lack day precision.
|
package/src/cli.js
CHANGED
|
@@ -14,7 +14,7 @@ import { parseArgs } from "node:util";
|
|
|
14
14
|
import { search, AskaipodsError } from "./client.js";
|
|
15
15
|
import { renderJson, renderMarkdown } from "./format.js";
|
|
16
16
|
|
|
17
|
-
const VERSION = "0.2.
|
|
17
|
+
const VERSION = "0.2.4";
|
|
18
18
|
|
|
19
19
|
const HELP_TEXT = `askaipods ${VERSION} — search AI podcast quotes by topic
|
|
20
20
|
|
|
@@ -30,8 +30,8 @@ OPTIONS:
|
|
|
30
30
|
-v, --version Show version
|
|
31
31
|
|
|
32
32
|
ENVIRONMENT:
|
|
33
|
-
ASKAIPODS_API_KEY PodLens API key. Without it:
|
|
34
|
-
With it:
|
|
33
|
+
ASKAIPODS_API_KEY PodLens API key. Without it: 20 searches/day per IP (anonymous).
|
|
34
|
+
With it: 100 searches/day per user (member).
|
|
35
35
|
Sign up at https://podlens.net to get one.
|
|
36
36
|
|
|
37
37
|
EXIT CODES:
|
package/src/client.js
CHANGED
|
@@ -137,7 +137,7 @@ export async function search({ query, days, apiKey, endpoint = PODLENS_ENDPOINT
|
|
|
137
137
|
|
|
138
138
|
const headers = {
|
|
139
139
|
"Content-Type": "application/json",
|
|
140
|
-
"User-Agent": "askaipods/0.2.
|
|
140
|
+
"User-Agent": "askaipods/0.2.4 (+https://github.com/Delibread0601/askaipods)",
|
|
141
141
|
};
|
|
142
142
|
if (apiKey) {
|
|
143
143
|
headers["X-PodLens-API-Key"] = apiKey;
|
|
@@ -190,15 +190,15 @@ export async function search({ query, days, apiKey, endpoint = PODLENS_ENDPOINT
|
|
|
190
190
|
// Distinguish 429 cases by inspecting the message: the server uses
|
|
191
191
|
// distinct strings for "burst limit hit" vs "daily quota exhausted",
|
|
192
192
|
// and only the latter warrants the "daily quota" exit code. The
|
|
193
|
-
// quota message is tier-aware: a member hitting the
|
|
193
|
+
// quota message is tier-aware: a member hitting the 100/day cap must
|
|
194
194
|
// not be told to "set ASKAIPODS_API_KEY" — they already have one.
|
|
195
195
|
if (response.status === 429) {
|
|
196
196
|
const msg = String(data?.error ?? "").toLowerCase();
|
|
197
197
|
if (msg.includes("quota")) {
|
|
198
198
|
const quotaMsg = apiKey
|
|
199
|
-
? "daily search quota exhausted (member tier:
|
|
200
|
-
: "daily search quota exhausted (anonymous tier:
|
|
201
|
-
"For
|
|
199
|
+
? "daily search quota exhausted (member tier: 100/day). Quota resets at 00:00 UTC."
|
|
200
|
+
: "daily search quota exhausted (anonymous tier: 20/day). Quota resets at 00:00 UTC. " +
|
|
201
|
+
"For 100 searches/day, set ASKAIPODS_API_KEY (sign up at https://podlens.net).";
|
|
202
202
|
throw exitErr(2, quotaMsg);
|
|
203
203
|
}
|
|
204
204
|
throw exitErr(3, "rate limited by podlens.net (too many requests in a short window). Retry in a minute.");
|
package/src/format.js
CHANGED
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
|
|
14
14
|
const ANONYMOUS_NOTE =
|
|
15
15
|
"Anonymous tier: 20 results sorted newest-first, dates fuzzed to month, " +
|
|
16
|
-
"--days capped at 90 when specified. Set ASKAIPODS_API_KEY for
|
|
16
|
+
"--days capped at 90 when specified. Set ASKAIPODS_API_KEY for 100 searches/day with full dates and unlimited lookback.";
|
|
17
17
|
|
|
18
18
|
// Sort results newest-first by parsing each `published_at` to a UTC
|
|
19
19
|
// millisecond timestamp and comparing numerically. Pure lexical compare
|