pi-producthunt
v0.1.3
Published
Pi extension package for Product Hunt research and digest workflows.
Maintainers
Readme
Pi Product Hunt
Product Hunt research and digest workflows inside Pi.
Pi Product Hunt is a read-only Pi extension package for Product Hunt market research. It calls the Product Hunt GraphQL API directly, adds interactive /producthunt:* commands for humans, and exposes structured tools for agents to gather launches, post details, comments, and digest-ready research notes.
Features
- Daily Product Hunt launch scans.
- Product/post search for competitor and trend research.
- Post detail and comment collection for user-reaction analysis.
- Digest-ready Markdown with sections for signals, reactions, and watchlists.
- Persistent login that stores your Product Hunt token in the Pi agent directory.
- Agent tools with typed parameters for autonomous Product Hunt research.
Install
pi install npm:pi-producthuntOr install from GitHub:
pi install git:github.com/eiei114/pi-producthuntTry without installing permanently:
pi -e npm:pi-producthuntFor local development from a checkout:
pi -e .Authentication
Use the interactive login command:
/producthunt:loginThis stores your token in:
~/.pi/agent/pi-producthunt-auth.jsonYou can remove the stored token with:
/producthunt:logoutYou can also provide a token through the environment. Environment auth takes priority over the stored login token:
export PRODUCTHUNT_ACCESS_TOKEN=...Commands
Commands are human-facing and require no fixed inline arguments. If input is needed, Pi asks interactively.
/producthunt:status
/producthunt:login
/producthunt:logout
/producthunt:today
/producthunt:search
/producthunt:post
/producthunt:comments
/producthunt:digest
/producthunt:researchExample flows:
/producthunt:today # today's launch list
/producthunt:search # asks for a search query
/producthunt:post # asks for slug, ID, or URL
/producthunt:comments # asks for slug, ID, or URL
/producthunt:digest # asks for today / yesterday / custom date
/producthunt:research # asks for a research topicAgent tools
Agents can call these typed tools directly:
producthunt_status
producthunt_get_posts
producthunt_search_posts
producthunt_get_post
producthunt_get_post_comments
producthunt_research_topic
producthunt_digestExamples:
producthunt_search_posts({ query: "AI coding agent", limit: 10 })
producthunt_get_post({ ref: "example-product-slug" })
producthunt_get_post_comments({ ref: "example-product-slug", limit: 10 })
producthunt_digest({ date: "2026-06-01", limit: 10 })Package contents
| Path | Purpose |
|---|---|
| extensions/ | Pi extension entrypoint and command/tool registration |
| lib/ | Product Hunt API client, auth store, formatters, schemas, helpers |
| docs/ | Release notes and usage examples |
| tests/ | Node test suite |
Development
npm install
npm run cinpm run ci runs:
- TypeScript typecheck
- Node tests
npm pack --dry-run
Release
This package supports npm Trusted Publishing, but you can also publish manually when needed:
npm publish --access public --otp <OTP>Do not store long-lived npm tokens in this repo.
Security
Pi packages execute with your local permissions. Review source before installing third-party packages.
Product Hunt tokens are never committed by this package. /producthunt:login stores the token locally in ~/.pi/agent/pi-producthunt-auth.json; /producthunt:logout deletes that stored file. PRODUCTHUNT_ACCESS_TOKEN is never modified by logout.
For vulnerability reporting, see SECURITY.md.
Links
- npm: https://www.npmjs.com/package/pi-producthunt
- GitHub: https://github.com/eiei114/pi-producthunt
- Issues: https://github.com/eiei114/pi-producthunt/issues
License
MIT
