Skip to content

Commit 9cb05c0

Browse files
celiasclaude
andcommitted
chore: merge Comic Vine keywords into lib/keywords.ts and remove extraction tooling
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent fce5ba0 commit 9cb05c0

12 files changed

Lines changed: 56 additions & 2125 deletions

.claude/agents/comic-vine-api.md

Lines changed: 0 additions & 57 deletions
This file was deleted.

.claude/agents/image-strategy.md

Lines changed: 1 addition & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Use this agent when work touches any of:
2626
- `dashboard/src/components/*`
2727
- Discord alert payload logic
2828

29-
Do not use this agent for unrelated architecture planning, generic UI redesign, or broad Comic Vine API work outside image enrichment.
29+
Do not use this agent for unrelated architecture planning or generic UI redesign.
3030

3131
## Product Direction To Preserve
3232

@@ -115,17 +115,9 @@ Failure handling:
115115

116116
## Commercial and Provider Guardrails
117117

118-
- Do not assume Comic Vine images are commercially approved.
119118
- Keep any provider fallback configurable and feature-flagged.
120119
- Log provider, match reason, and confidence for auditability.
121120

122-
If Comic Vine is involved at all, enforce:
123-
124-
- Minimum 20-second delay between requests
125-
- `COMIC_VINE_API_KEY` from env only
126-
- Descriptive `User-Agent`
127-
- Safe handling of non-OK and API error payloads
128-
129121
## Enrichment Rules (Phase 2)
130122

131123
Only attempt enrichment when:

.github/instructions/api-files.instructions.md

Lines changed: 0 additions & 67 deletions
This file was deleted.

.github/prompts/test-comic-vine-api.prompt.md

Lines changed: 0 additions & 41 deletions
This file was deleted.

.gitignore

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,6 @@ build/
1414

1515
# Cache directories (do not commit)
1616
.turbo/
17-
comic-vine-cache/
1817

1918
# Generated files
2019
/generated/prisma/

HANDOFF-image-strategy-agent.md

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,6 @@
33
## Target Agent
44

55
- Preferred: architect
6-
- Secondary (Comic Vine specifics only): comic-vine-api
76

87
## Why This Exists
98

@@ -115,7 +114,6 @@ Dashboard compatibility notes:
115114

116115
## Commercial-Use Guardrails
117116

118-
- Do not assume Comic Vine images are commercially allowed for this app without explicit approval.
119117
- Build provider fallback behind a feature flag (for example IMAGE_ENRICHMENT_ENABLED).
120118
- Keep provider selection configurable so legal-approved source can be swapped without schema changes.
121119
- Log provider, match reason, and confidence for auditability.
@@ -128,13 +126,6 @@ Dashboard compatibility notes:
128126
- Add rate limiting and retries with backoff for any external API.
129127
- Ensure enrichment work does not block reddit poller loops or API responsiveness.
130128

131-
If Comic Vine is used at all:
132-
133-
- Respect 20-second delay between requests.
134-
- Use COMIC_VINE_API_KEY from environment only.
135-
- Use descriptive User-Agent header.
136-
- Validate response error payloads and handle non-OK safely.
137-
138129
## Matching Quality Rules (Fallback Provider)
139130

140131
- Normalize title by removing sale noise words and price fragments.

README.md

Lines changed: 0 additions & 76 deletions
Original file line numberDiff line numberDiff line change
@@ -95,60 +95,6 @@ The Express server exposes three endpoints:
9595

9696
---
9797

98-
## Comic Vine API Integration
99-
100-
The project includes Comic Vine API integration for extracting character, series, and publisher keywords to enhance comic detection.
101-
102-
### One-Time Keyword Extraction
103-
104-
Extract high-value keywords from Comic Vine's database:
105-
106-
```bash
107-
# Set up Comic Vine API key
108-
echo "COMIC_VINE_API_KEY=your_api_key_here" >> .env
109-
110-
# Full extraction (respects rate limits)
111-
node extract-comic-vine-keywords.js
112-
113-
# Testing modes (no duplicate API calls)
114-
node extract-comic-vine-keywords.js --test characters --limit 10
115-
node extract-comic-vine-keywords.js --dry-run
116-
node extract-comic-vine-keywords.js --cache-only
117-
118-
# Show all options
119-
node extract-comic-vine-keywords.js --help
120-
```
121-
122-
**Features:**
123-
124-
- **Automatic caching** - Stores responses to avoid duplicate API calls
125-
- **Rate limit compliance** - 20-second delays between requests (200/hour limit)
126-
- **Testing modes** - Dry run, cache-only, endpoint testing
127-
- **ES module output** - Generates `comic-vine-keywords.js` for integration
128-
129-
### VS Code Copilot Customizations
130-
131-
The project includes specialized Copilot customizations for Comic Vine API development:
132-
133-
**🤖 Comic Vine API Agent** (`@comic-vine-api`)
134-
135-
- Expert guidance on Comic Vine endpoints, rate limits, authentication
136-
- Project-aware responses using existing code patterns
137-
- Usage: `@comic-vine-api How do I search for characters by popularity?`
138-
139-
**⚙️ Automatic API Patterns**
140-
141-
- Auto-applied to any file matching `*{api,vine,comic}*.{js,ts,mjs}`
142-
- Enforces rate limiting, error handling, authentication patterns
143-
144-
**🧪 API Testing Prompt** (`/test-comic-vine-api`)
145-
146-
- Generates test scripts for any Comic Vine endpoint
147-
- Includes proper rate limiting and error handling
148-
- Usage: `/test-comic-vine-api` → specify endpoint and parameters
149-
150-
---
151-
15298
Edit `SCORE_THRESHOLD` in `lib/config.js`:
15399

154100
| Threshold | What you get |
@@ -164,13 +110,6 @@ To add content keywords, edit the `KEYWORDS` array in `lib/keywords.js`:
164110
["your keyword", pointValue],
165111
```
166112

167-
**Comic Vine Integration**: Import extracted keywords from Comic Vine extraction:
168-
169-
```js
170-
import { COMIC_VINE_KEYWORDS } from "./comic-vine-keywords.js";
171-
// Merge high-value keywords into main KEYWORDS array
172-
```
173-
174113
To add location keywords (South/Central NJ area), edit `LOCATION_KEYWORDS` in `lib/config.js`.
175114

176115
---
@@ -217,18 +156,3 @@ npm run build
217156
- eBay flip value — price lookup on local posts once API key arrives
218157
- Facebook Marketplace — Playwright scraper, geo-targeted listings
219158
- Buy Nothing — Facebook Buy Nothing group scraper (same session as Marketplace)
220-
221-
---
222-
223-
## VS Code Development
224-
225-
This project includes custom VS Code Copilot configurations:
226-
227-
| File | Purpose |
228-
| ------------------------------------------------ | ---------------------------------------------- |
229-
| `.github/agents/comic-vine-api.agent.md` | Comic Vine API specialist agent |
230-
| `.github/copilot-instructions.md` | Workspace-wide Comic Vine rate limit awareness |
231-
| `.github/instructions/api-files.instructions.md` | Auto-applied patterns for API files |
232-
| `.github/prompts/test-comic-vine-api.prompt.md` | API testing prompt |
233-
234-
Use `@comic-vine-api` for Comic Vine API questions or `/test-comic-vine-api` to generate test scripts.

0 commit comments

Comments
 (0)