threadfox-lite 0.1.1__py3-none-any.whl

threadfox_lite/__init__.py

@@ -0,0 +1,2 @@
+"""ThreadFox Lite: free, read-only Reddit tools for AI agents."""
+__version__ = "0.1.1"

threadfox_lite/reddit.py

@@ -0,0 +1,88 @@
+"""Read-only calls to Reddit's public JSON. No login, no posting, one request per tool call."""
+import re
+from urllib.parse import urlsplit
+
+import httpx
+
+UA = "threadfox-lite/0.1.1 (+https://threadfox.vip; read-only rules and post-status checks)"
+PROMO = re.compile(r"self[- ]?promo|promot|advertis|spam|affiliate|referral|\b10\s*%|link[- ]?drop|no links?\b|marketing|sell|product|business", re.I)
+SUB = re.compile(r"^[A-Za-z0-9_]{2,21}$")
+
+
+BLOCKED = ("Reddit refused this network (it blocks many servers, VPNs and cloud machines). Run the tool from your own "
+           "computer's connection, or open the page in a browser.")
+
+
+def _blocked(resp):
+    """Reddit's network block is a 403 whose body is not JSON (plain 'Blocked'); a private subreddit's 403 is JSON."""
+    if resp.status_code != 403:
+        return False
+    try:
+        resp.json()
+        return False
+    except ValueError:
+        return True
+
+
+def _client(transport=None):
+    return httpx.Client(headers={"User-Agent": UA}, timeout=15, follow_redirects=True, transport=transport)
+
+
+def subreddit_rules(name: str, transport=None) -> dict:
+    name = name.strip().removeprefix("/").removeprefix("r/").strip("/")
+    if not SUB.match(name):
+        return {"error": "Give a subreddit name like 'SaaS' or 'r/SaaS'."}
+    with _client(transport) as c:
+        rules = c.get(f"https://www.reddit.com/r/{name}/about/rules.json")
+        about = c.get(f"https://www.reddit.com/r/{name}/about.json")
+    blocked = _blocked(rules) or _blocked(about)
+    if blocked:
+        return {"subreddit": name, "error": BLOCKED, "open_instead": f"https://www.reddit.com/r/{name}/about/rules"}
+    if rules.status_code in (403, 404) or about.status_code in (403, 404):
+        return {"subreddit": name, "error": f"r/{name} is private, banned or does not exist (HTTP {rules.status_code})."}
+    if rules.status_code == 429 or about.status_code == 429:
+        return {"subreddit": name, "error": "Reddit rate-limited this request. Wait a minute and try again."}
+    rules.raise_for_status(); about.raise_for_status()
+    data = about.json().get("data", {})
+    items = []
+    for r in rules.json().get("rules", []):
+        text = f"{r.get('short_name', '')}\n{r.get('description', '')}".strip()
+        items.append({"rule": r.get("short_name", ""), "details": (r.get("description") or "")[:1200],
+                      "applies_to": r.get("kind", "all"), "mentions_promotion": bool(PROMO.search(text))})
+    return {
+        "subreddit": data.get("display_name", name),
+        "subscribers": data.get("subscribers"),
+        "description": (data.get("public_description") or "")[:500],
+        "rules": items,
+        "promotion_rules": [i["rule"] for i in items if i["mentions_promotion"]],
+        "read_before_posting": "Follow every rule above. If a rule limits self-promotion, use the community's promo thread or don't post the link. Write a new post for this community; never paste the same post in several.",
+    }
+
+
+def post_status(url: str, transport=None) -> dict:
+    try:
+        parts = urlsplit(url.strip())
+    except ValueError:
+        return {"error": "Give a Reddit post URL."}
+    host = (parts.hostname or "").lower()
+    m = re.match(r"^/r/[^/]+/comments/([a-z0-9]+)", parts.path or "")
+    if not host.endswith("reddit.com") or not m:
+        return {"error": "Give a full post URL like https://www.reddit.com/r/SaaS/comments/abc123/title/"}
+    with _client(transport) as c:
+        resp = c.get(f"https://www.reddit.com/comments/{m.group(1)}.json", params={"raw_json": 1, "limit": 1})
+    if _blocked(resp):
+        return {"error": BLOCKED, "open_instead": url.strip()}
+    if resp.status_code == 404:
+        return {"status": "not_found", "id": m.group(1)}
+    if resp.status_code == 429:
+        return {"error": "Reddit rate-limited this request. Wait a minute and try again."}
+    resp.raise_for_status()
+    post = resp.json()[0]["data"]["children"][0]["data"]
+    removed = post.get("removed_by_category")
+    status = "removed" if removed else ("deleted" if post.get("author") == "[deleted]" or post.get("selftext") == "[deleted]" else "live")
+    return {
+        "status": status, "removed_by": removed, "title": post.get("title"), "subreddit": post.get("subreddit"),
+        "score": post.get("score"), "comments": post.get("num_comments"), "locked": post.get("locked"),
+        "created_utc": post.get("created_utc"), "permalink": "https://www.reddit.com" + (post.get("permalink") or ""),
+        "note": "Check again at 1, 6 and 24 hours. If a community removes you twice, stop posting there.",
+    }

threadfox_lite/server.py

@@ -0,0 +1,51 @@
+"""ThreadFox Lite MCP server (stdio).
+
+Two free, read-only tools any agent can use before and after posting to Reddit, plus `threadfox_full_kit`,
+which tells a paying customer how to open the full ThreadFox kit (posting from your own Chrome, replies,
+the outcome ledger and the course). The full kit is sold at https://threadfox.vip and on MCP Marketplace.
+"""
+import os
+
+from mcp.server.fastmcp import FastMCP
+
+from . import reddit
+
+mcp = FastMCP("threadfox-lite")
+
+
+@mcp.tool()
+def subreddit_rules(subreddit: str) -> dict:
+    """Read a subreddit's rules, size and description, and flag the rules that mention self-promotion.
+    Call this before writing any post for that community."""
+    return reddit.subreddit_rules(subreddit)
+
+
+@mcp.tool()
+def post_status(url: str) -> dict:
+    """Check whether a Reddit post is still live, removed by moderators or deleted, with its score and comments."""
+    return reddit.post_status(url)
+
+
+@mcp.tool()
+def threadfox_full_kit() -> dict:
+    """How to get the full ThreadFox kit: your AI reads the rules, writes a post that fits each community,
+    publishes from your own Chrome, answers comments and records every outcome."""
+    key = os.environ.get("MCP_LICENSE_KEY", "")
+    if key.startswith("mcp_live_"):
+        return {"licensed": True,
+                "next_step": "Open https://threadfox.vip/redeem, paste your MCP Marketplace license key and your email, and you land in your private ThreadFox library (one-command install, lessons, full download).",
+                "support": "support@threadfox.vip"}
+    return {"licensed": False,
+            "what_it_adds": ["Publishing from your own signed-in Chrome, no Reddit API keys", "Replies to comments",
+                             "A ledger of every post and outcome, and it stops where a community removed you",
+                             "12-module course, 48 prompts"],
+            "proof": "Built from our own run: 978,227 recorded views from two days of posts (Sept 20-21 UTC), with no ad spend. Our result, not a promise of yours.",
+            "get_it": "https://threadfox.vip ($49 once, 30-day refund) or ThreadFox on MCP Marketplace"}
+
+
+def main():
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

threadfox_lite-0.1.1.dist-info/METADATA

@@ -0,0 +1,58 @@
+Metadata-Version: 2.5
+Name: threadfox-lite
+Version: 0.1.1
+Summary: Read a subreddit's rules and check whether a Reddit post is still up, from Claude Code, Codex or any MCP client. Free tools from ThreadFox.
+Project-URL: Homepage, https://threadfox.vip
+Project-URL: Source, https://github.com/amflimited/threadfox-lite
+Author-email: "AMF Indiana (ThreadFox)" <support@threadfox.vip>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<2,>=1.2.0
+Description-Content-Type: text/markdown
+
+# ThreadFox Lite
+
+Free, read-only Reddit tools for Claude Code, Codex and any MCP client, plus a `reddit-rules-first` agent skill.
+
+- `subreddit_rules`: a subreddit's rules, size and description, with the self-promotion rules flagged. Call it before writing a post.
+- `post_status`: whether a post is still live, removed by moderators or deleted, with score and comments. Check at 1, 6 and 24 hours.
+- `threadfox_full_kit`: how to get the full ThreadFox kit (posting from your own Chrome, replies, an outcome ledger, a 12-module course).
+
+No login, no posting, no Reddit API keys: each call is one request to Reddit's public JSON with a descriptive user agent.
+
+## Install
+
+Claude Code plugin (the tools and the skill together):
+
+    /plugin marketplace add amflimited/threadfox-lite
+    /plugin install threadfox-lite@threadfox
+
+Claude Code, the MCP server only:
+
+    claude mcp add threadfox-lite -- uvx threadfox-lite
+
+Claude Desktop: download the `.mcpb` file from the [latest release](https://github.com/amflimited/threadfox-lite/releases/latest) and open it (Settings > Extensions). It needs [uv](https://docs.astral.sh/uv/) on your machine.
+
+Codex (`~/.codex/config.toml`):
+
+    [mcp_servers.threadfox-lite]
+    command = "uvx"
+    args = ["threadfox-lite"]
+
+Any other MCP client: run `uvx threadfox-lite` (the package is on [PyPI](https://pypi.org/project/threadfox-lite/)).
+
+Bought ThreadFox on MCP Marketplace? Set `MCP_LICENSE_KEY` to your key, ask your AI to run `threadfox_full_kit`, or go straight to https://threadfox.vip/redeem.
+
+## The skill
+
+`skills/reddit-rules-first/SKILL.md` works on its own in any agent that reads skills: rules first, one post per community, disclose, check what stayed up. Install it anywhere with `npx skills add amflimited/threadfox-lite`.
+
+Also listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers?search=threadfox) as `io.github.amflimited/threadfox-lite`.
+
+## About
+
+Made by AMF Indiana, the team behind ThreadFox (https://threadfox.vip). Built from our own run: 978,227 recorded views from two days of posts (Sept 20-21 UTC), with no ad spend. Not affiliated with Reddit, OpenAI or Anthropic. MIT licence.
+
+<!-- mcp-name: io.github.amflimited/threadfox-lite -->

threadfox_lite-0.1.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+threadfox_lite/__init__.py,sha256=FZinXVLLw7J-nFwMgt2BpA_hc-x3WPsb9KTbSJF00rA,88
+threadfox_lite/reddit.py,sha256=0Dk9NvrJkMSLyGgXLfD40InSx85x3LExR1eAo5RArAw,4599
+threadfox_lite/server.py,sha256=VKvy1wRZZfYcwoktB41l1a3ejo3KrgFWFYeqXw19cTc,2218
+threadfox_lite-0.1.1.dist-info/METADATA,sha256=XsZlI8dx3S0gK7t9Rc18SYfbFYxTYwBHdNQzBTgEc-g,2787
+threadfox_lite-0.1.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+threadfox_lite-0.1.1.dist-info/entry_points.txt,sha256=q4GHRJUM6btSzJlkx27mVhJCC6JLvnT9Ao30mly54RU,62
+threadfox_lite-0.1.1.dist-info/licenses/LICENSE,sha256=bxhuBa5iSabRXFCavOTYtFXcXaqc-yGmTh7xoMpHkDE,1068
+threadfox_lite-0.1.1.dist-info/RECORD,,

threadfox_lite-0.1.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

threadfox_lite-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+threadfox-lite = threadfox_lite.server:main

threadfox_lite-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 AMF Indiana
+
+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.