diff --git a/.agents/plugins/marketplace.json b/.agents/plugins/marketplace.json index a635cd93..e4b4f452 100644 --- a/.agents/plugins/marketplace.json +++ b/.agents/plugins/marketplace.json @@ -490,6 +490,20 @@ "description": "13 skills for image, video, and audio generation using 100+ models - FLUX, Midjourney v7, Veo3, Kling 3.0, Suno, and HunyuanVideo via muapi.ai.", "icon": "./plugins/SamurAIGPT/Generative-Media-Skills/assets/icon.svg" }, + { + "name": "haunt-mcp", + "displayName": "Haunt MCP", + "source": { + "source": "local", + "path": "./plugins/Darko893/mcp-server" + }, + "policy": { + "installation": "AVAILABLE", + "authentication": "ON_INSTALL" + }, + "category": "Tools & Integrations", + "description": "Web extraction MCP for permitted public pages. Returns clean JSON, Markdown, article fields, metadata, and usage with clear blocked-page errors." + }, { "name": "hol-guard-plugin", "displayName": "HOL Guard Plugin", diff --git a/README.md b/README.md index 63d31fb5..54197171 100644 --- a/README.md +++ b/README.md @@ -174,6 +174,7 @@ Third-party plugins built by the community. [PRs welcome](#contributing)! - [GCF Proxy](https://github.com/blackwell-systems/gcf-codex-plugin) - Save 71% on MCP tool call tokens by wrapping any server with GCF encoding, with session stats hook and setup skill. - [GrayMatter](https://github.com/ValkyrLabs/GrayMatter) - Durable memory and shared graph state for Codex and OpenClaw agents, with live ValkyrAI schema awareness. - [Generative Media Skills](https://github.com/SamurAIGPT/Generative-Media-Skills) - 13 skills for image, video, and audio generation using 100+ models - FLUX, Midjourney v7, Veo3, Kling 3.0, Suno, and HunyuanVideo via muapi.ai. +- [Haunt MCP](https://github.com/Darko893/mcp-server) - Web extraction MCP for permitted public pages. Returns clean JSON, Markdown, article fields, metadata, and usage with clear blocked-page errors. - [HOL Guard Plugin](https://github.com/hashgraph-online/hol-guard-plugin) - AI antivirus workflow for Codex, Claude Code, Cursor, Gemini, OpenCode, MCP servers, skills, and plugin release checks with local approvals and receipts. - [HOTL Plugin](https://github.com/yimwoo/hotl-plugin) - Human-on-the-Loop AI coding workflow plugin for Codex, Claude Code, and Cline with structured planning, review, and verification guardrails. - [LLM Transpile](https://github.com/epicsagas/llm-transpile) - Auto-compress .md, .html, and .txt files via PostToolUse hook, cutting context usage by up to 40% with zero workflow change. diff --git a/plugins.json b/plugins.json index d2d1f21e..a444e359 100644 --- a/plugins.json +++ b/plugins.json @@ -3,7 +3,7 @@ "name": "awesome-codex-plugins", "version": "1.0.0", "last_updated": "2026-06-16", - "total": 112, + "total": 113, "categories": [ "Development & Workflow", "Tools & Integrations" @@ -339,6 +339,16 @@ "source": "awesome-codex-plugins", "install_url": "https://raw.githubusercontent.com/SamurAIGPT/Generative-Media-Skills/HEAD/.codex-plugin/plugin.json" }, + { + "name": "Haunt MCP", + "url": "https://github.com/Darko893/mcp-server", + "owner": "Darko893", + "repo": "mcp-server", + "description": "Web extraction MCP for permitted public pages. Returns clean JSON, Markdown, article fields, metadata, and usage with clear blocked-page errors.", + "category": "Tools & Integrations", + "source": "awesome-codex-plugins", + "install_url": "https://raw.githubusercontent.com/Darko893/mcp-server/HEAD/.codex-plugin/plugin.json" + }, { "name": "HOL Guard Plugin", "url": "https://github.com/hashgraph-online/hol-guard-plugin", diff --git a/plugins/Darko893/mcp-server/.codex-plugin/plugin.json b/plugins/Darko893/mcp-server/.codex-plugin/plugin.json new file mode 100644 index 00000000..e25597b5 --- /dev/null +++ b/plugins/Darko893/mcp-server/.codex-plugin/plugin.json @@ -0,0 +1,46 @@ +{ + "name": "haunt-mcp", + "description": "Adds Haunt MCP web extraction: permitted public URL to clean JSON, Markdown, article fields, metadata, and usage checks.", + "version": "1.0.23", + "author": { + "name": "Haunt API", + "email": "support@hauntapi.com", + "url": "https://hauntapi.com" + }, + "homepage": "https://hauntapi.com", + "repository": "https://github.com/Darko893/mcp-server", + "license": "MIT", + "keywords": [ + "mcp", + "web-extraction", + "structured-data", + "markdown", + "claude", + "cursor", + "codex", + "opencode", + "ai-agent" + ], + "skills": "./skills/", + "mcpServers": "./.mcp.json", + "interface": { + "displayName": "Haunt MCP", + "shortDescription": "Extract permitted public pages to JSON or Markdown from Codex.", + "longDescription": "Haunt gives Codex an MCP web-extraction tool for permitted public pages. Use a no-key demo first, then add HAUNT_API_KEY for live URL-to-JSON, Markdown, article, metadata, and usage tools with clear blocked-page errors.", + "developerName": "Haunt API", + "category": "Tools & Integrations", + "capabilities": [ + "mcp", + "web-extraction", + "structured-data", + "markdown" + ], + "websiteURL": "https://hauntapi.com", + "privacyPolicyURL": "https://hauntapi.com/privacy", + "termsOfServiceURL": "https://hauntapi.com/terms", + "brandColor": "#39ff88", + "defaultPrompt": [ + "Use Haunt to run try_demo_extract and show me the docs and signup links." + ] + } +} diff --git a/plugins/Darko893/mcp-server/.codexignore b/plugins/Darko893/mcp-server/.codexignore new file mode 100644 index 00000000..930d4a91 --- /dev/null +++ b/plugins/Darko893/mcp-server/.codexignore @@ -0,0 +1,5 @@ +.git/ +node_modules/ +*.tgz +.env +.env.* diff --git a/plugins/Darko893/mcp-server/.mcp.json b/plugins/Darko893/mcp-server/.mcp.json new file mode 100644 index 00000000..b2f03197 --- /dev/null +++ b/plugins/Darko893/mcp-server/.mcp.json @@ -0,0 +1,14 @@ +{ + "mcpServers": { + "haunt": { + "command": "npx", + "args": [ + "-y", + "@hauntapi/mcp-server" + ], + "env": { + "HAUNT_API_KEY": "${HAUNT_API_KEY}" + } + } + } +} diff --git a/plugins/Darko893/mcp-server/LICENSE b/plugins/Darko893/mcp-server/LICENSE new file mode 100644 index 00000000..fc28e129 --- /dev/null +++ b/plugins/Darko893/mcp-server/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Haunt API + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/plugins/Darko893/mcp-server/README.md b/plugins/Darko893/mcp-server/README.md new file mode 100644 index 00000000..9a19f75c --- /dev/null +++ b/plugins/Darko893/mcp-server/README.md @@ -0,0 +1,138 @@ +# Haunt API MCP Server + +This is the canonical public MCP package working tree for `@hauntapi/mcp-server` and GitHub `Darko893/mcp-server`. The live Haunt API app/site lives separately in `/root/haunt`. Do not confuse this with `/root/haunt/mcp-server`, which is a legacy/local copy inside the app repo. + +Give Claude, Cursor, Windsurf, and other MCP-compatible agents a clean web extraction tool. + +Haunt turns permitted public web pages into structured JSON using natural-language prompts. It can also return clean Markdown for agents, RAG pipelines, notes, and `.md` files when you need page text instead of typed fields. It is built for agent workflows that need product data, competitor pricing, article content, metadata, lead lists, research snippets, Markdown page text, or other visible web data without maintaining brittle selectors. + +## Quick Start + +### One-command agent setup + +For the clean CLI path, run: + +```bash +npx -y --package @hauntapi/cli@latest haunt-cli init +``` + +If you already have a Haunt API key: + +```bash +HAUNT_API_KEY=PASTE_YOUR_KEY_HERE npx -y --package @hauntapi/cli@latest haunt-cli init +``` + +The CLI prints the MCP config for Claude, Cursor, Windsurf, and other MCP-compatible clients. It does not edit config files for you. + +### 1. Prove the MCP package is wired in, no key needed + +Install the MCP server and call `try_demo_extract` first. It returns a fixed sample extraction JSON/trace plus docs, signup, pricing, and free-tier links without using credits. + +```text +Use Haunt's try_demo_extract tool and show me the signup and docs links. +``` + +### 2. Add a free API key for live extraction + +Get a free API key: https://hauntapi.com/#signup + +Add this to your MCP client config: + +```json +{ + "mcpServers": { + "haunt": { + "command": "npx", + "args": ["-y", "@hauntapi/mcp-server"], + "env": { + "HAUNT_API_KEY": "your-api-key" + } + } + } +} +``` + +Then ask your agent: + +```text +Use Haunt to extract the product name, price, availability, and review count from https://example.com/product +``` + +For Markdown output: + +```text +Use Haunt extract_markdown to turn https://example.com/docs into clean Markdown. +``` + + +## Capability boundaries + +Haunt does **not** promise universal extraction, CAPTCHA solving, login-wall access, paywall access, or anti-bot circumvention. It works best on permitted public pages and supported rendered pages. When a page is blocked, login-required, CAPTCHA-gated, or too thin to verify, Haunt returns a clear failure signal instead of fabricated data. + +## Tools + +### `try_demo_extract` + +No-key activation check. Returns a fixed sample extraction JSON/trace, Haunt's demo endpoint, docs, signup, pricing, MCP info route, and free-tier details. Use this first when a user has installed the MCP server but has not added `HAUNT_API_KEY` yet. + +### `extract` / `extract_url` + +General-purpose extraction from permitted public web pages. `extract` and `extract_url` are aliases so hosted MCP docs and local stdio package users can follow the same wording. + +Use it for: + +- Product names, prices, stock status, reviews +- Competitor pricing pages +- Directories and lead lists +- Job boards +- Research pages +- Supported permitted public pages where you want clean JSON instead of HTML + +It accepts optional `response_format` values: `json` (default), `markdown` / `md`, and `raw_html` / `html`. + +### `extract_markdown` + +Return clean Markdown from a permitted public page. Use this when the agent or workflow wants readable page text for RAG, notes, docs ingestion, or saving as a `.md` file instead of structured fields. + +### `extract_article` + +Extract article fields from news, blog, and editorial pages. + +Returns title, body text, author, and publish date when available. + +### `extract_metadata` + +Extract page metadata including title, description, Open Graph tags, Twitter Card tags, canonical URL, and related metadata. + +### `get_usage` + +Check current plan, monthly credit limit, used credits, reserved credits, and remaining credits. Use this after a live extraction to see what was charged. + +## Why Haunt + +- Natural-language prompts instead of fragile CSS selectors +- Supported fetch paths for JavaScript-heavy pages +- Challenge-aware extraction with machine-readable verification signals (`error_code`, `captcha_provider`, `requires_human_verification`) +- Clean JSON output for agents, databases, and workflows +- Clean Markdown output when the job is page text for agents, RAG, notes, or `.md` files +- Free tier for testing + +## Pricing + +| Plan | Credits | Price | +|------|---------|-------| +| Free | 1,000/mo | £0 | +| Starter | 10,000/mo | £19/mo | +| Pro | 30,000/mo | £49/mo | +| Scale | 80,000/mo | £99/mo | + +Credits are not one-to-one requests. Simple public/non-LLM output usually uses 1 credit, normal structured extraction 2, browser-rendered or authenticated extraction 4, and heavy/screenshot extraction 8. Failed, blocked, login/CAPTCHA, provider, and server failures do not burn credits. + +Upgrade: https://hauntapi.com/#pricing + +## Links + +- Website: https://hauntapi.com +- Docs: https://hauntapi.com/docs +- Get API key: https://hauntapi.com/#signup +- GitHub: https://github.com/Darko893/mcp-server diff --git a/plugins/Darko893/mcp-server/SECURITY.md b/plugins/Darko893/mcp-server/SECURITY.md new file mode 100644 index 00000000..d191850d --- /dev/null +++ b/plugins/Darko893/mcp-server/SECURITY.md @@ -0,0 +1,7 @@ +# Security Policy + +Report security issues privately to support@hauntapi.com. + +Do not open public issues containing secrets, API keys, customer data, exploit details, or private URLs. + +Haunt is designed for permitted public pages and supported rendered pages. It does not promise CAPTCHA solving, login-wall access, paywall access, restricted-page access, or anti-bot circumvention. diff --git a/plugins/Darko893/mcp-server/package-lock.json b/plugins/Darko893/mcp-server/package-lock.json new file mode 100644 index 00000000..f6497020 --- /dev/null +++ b/plugins/Darko893/mcp-server/package-lock.json @@ -0,0 +1,17 @@ +{ + "name": "@hauntapi/mcp-server", + "version": "1.0.23", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "@hauntapi/mcp-server", + "version": "1.0.23", + "license": "MIT", + "bin": { + "haunt-mcp": "index.js", + "mcp-server": "index.js" + } + } + } +} diff --git a/plugins/Darko893/mcp-server/package.json b/plugins/Darko893/mcp-server/package.json new file mode 100644 index 00000000..58320b0e --- /dev/null +++ b/plugins/Darko893/mcp-server/package.json @@ -0,0 +1,54 @@ +{ + "name": "@hauntapi/mcp-server", + "version": "1.0.23", + "mcpName": "com.hauntapi/haunt", + "description": "MCP web extraction for permitted public pages: no-key demo plus live URL-to-JSON and Markdown output with honest blocked-page errors", + "main": "index.js", + "type": "module", + "bin": { + "mcp-server": "index.js", + "haunt-mcp": "index.js" + }, + "files": [ + "index.js", + "README.md", + "LICENSE", + "server.json", + "glama.json" + ], + "scripts": { + "start": "node index.js", + "test": "node --test" + }, + "keywords": [ + "mcp", + "mcp-server", + "model-context-protocol", + "claude", + "cursor", + "ai-agent", + "web-scraping", + "web-extraction", + "data-extraction", + "structured-data", + "markdown", + "markdown-extraction", + "clean-failure", + "scraper-api", + "json-extraction", + "javascript-rendering", + "challenge-aware", + "honest-failure" + ], + "author": "Haunt API", + "license": "MIT", + "repository": { + "type": "git", + "url": "git+https://github.com/Darko893/mcp-server.git" + }, + "dependencies": {}, + "homepage": "https://hauntapi.com", + "bugs": { + "url": "https://github.com/Darko893/mcp-server/issues" + } +} diff --git a/plugins/Darko893/mcp-server/skills/haunt-web-extraction/SKILL.md b/plugins/Darko893/mcp-server/skills/haunt-web-extraction/SKILL.md new file mode 100644 index 00000000..7171c0df --- /dev/null +++ b/plugins/Darko893/mcp-server/skills/haunt-web-extraction/SKILL.md @@ -0,0 +1,31 @@ +--- +name: haunt-web-extraction +description: Use Haunt MCP to extract structured JSON, clean Markdown, article fields, metadata, or usage from permitted public web pages. +disable-model-invocation: true +--- + +# Haunt Web Extraction + +Use this skill when the user needs data from a permitted public web page inside Claude Code, Cursor, Codex, OpenCode, or another MCP-aware coding agent. + +## First action + +If the Haunt MCP server is installed but no API key is configured yet, call `try_demo_extract` first. It proves the server is wired correctly and returns docs, signup, pricing, MCP info, and free-tier links without using credits. + +## Live extraction + +For live pages, require `HAUNT_API_KEY` in the MCP server environment. Use: + +- `extract_url` or `extract` for structured JSON from a permitted public URL. +- `extract_markdown` for readable page text for RAG, notes, docs ingestion, or `.md` files. +- `extract_article` for public article pages. +- `extract_metadata` for titles, descriptions, Open Graph, Twitter Card, and canonical URL metadata. +- `get_usage` after live calls to check plan and remaining credits. + +## Boundaries + +Haunt is for permitted public pages and supported rendered pages. It does not promise CAPTCHA solving, login-wall access, paywall access, restricted-page access, or anti-bot circumvention. If a page is blocked, login-required, CAPTCHA-gated, paywalled, restricted, or too thin to verify, treat Haunt's clear failure signal as the correct result. Do not fabricate extracted data. + +## Good prompt pattern + +"Use Haunt to extract the product name, price, availability, and review count from this permitted public URL: . Return JSON and tell me if the page was blocked or unverifiable."