Skip to content

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

chore: repo cleanup, drop obsolete files and unused python-dotenv

Pnantdd5dc7cc9724
diff --git a/.env.example b/.env.example
deleted file mode 100644
index 989daba3..00000000
--- a/.env.example
+++ /dev/null
@@ -1,18 +0,0 @@
-# Agent Reach Configuration
-# Copy to .env and fill in your values
-# Or use: agent-reach configure
-
-# Exa Search (free 1000/month) — https://exa.ai
-# EXA_API_KEY=exa-your-key-here
-
-# GitHub Token (optional, for higher rate limits) — https://github.com/settings/tokens
-# GITHUB_TOKEN=ghp_your_token_here
-
-# Reddit ISP Proxy (optional, for full Reddit access)
-# REDDIT_PROXY=http://user:pass@ip:port
-
-# Groq Whisper (optional, for video transcription) — https://console.groq.com
-# GROQ_API_KEY=gsk_your_key_here
-
-# OpenAI Whisper (optional fallback when Groq is rate-limited) — https://platform.openai.com
-# OPENAI_API_KEY=sk-your_key_here
diff --git a/.gitignore b/.gitignore
index f3d65c6d..19e12360 100644
--- a/.gitignore
+++ b/.gitignore
@@ -5,6 +5,10 @@ __pycache__/
*.egg-info/
dist/
build/
+.venv/
+.mypy_cache/
+.ruff_cache/
+.DS_Store
.env
.agent-reach/
*.log
diff --git a/.openteams/specs/2026-07-10-agent-skills-hub-friend-link-design.html b/.openteams/specs/2026-07-10-agent-skills-hub-friend-link-design.html
deleted file mode 100644
index a5735b63..00000000
--- a/.openteams/specs/2026-07-10-agent-skills-hub-friend-link-design.html
+++ /dev/null
@@ -1,37 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-<head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width, initial-scale=1">
- <title>Agent Skills Hub 友链设计</title>
- <style>
- :root { color-scheme: light; --ink: #18212f; --muted: #5e6b7c; --line: #dce3ec; --accent: #2563eb; }
- body { margin: 0; background: #f5f7fb; color: var(--ink); font: 16px/1.65 system-ui, -apple-system, sans-serif; }
- main { max-width: 760px; margin: 56px auto; padding: 36px; background: #fff; border: 1px solid var(--line); border-radius: 18px; box-shadow: 0 18px 50px rgba(24, 33, 47, .08); }
- h1 { margin: 0 0 8px; font-size: 30px; letter-spacing: -.02em; }
- h2 { margin-top: 30px; font-size: 18px; }
- p { margin: 8px 0; }
- .meta { color: var(--muted); }
- .copy { padding: 16px 18px; border-left: 4px solid var(--accent); background: #f7f9ff; border-radius: 8px; }
- code { color: #1d4ed8; background: #eef3ff; padding: 2px 5px; border-radius: 5px; }
- </style>
-</head>
-<body>
- <main>
- <h1>Agent Skills Hub 友链设计</h1>
- <p class="meta">2026-07-10 · Agent Reach README 双语同步</p>
-
- <h2>目标与范围</h2>
- <p>在中文 <code>README.md</code> 的“友情链接”和英文 <code>docs/README_en.md</code> 的“Friends”中,各新增一条 Agent Skills Hub 链接。放在腾讯云 OpenClaw 之后、AtomGit 镜像之前;不改动其他内容。</p>
-
- <h2>中文文案</h2>
- <p class="copy"><strong>Agent Skills Hub</strong> — 找 Claude 技能和 MCP 服务器,不用猜哪个安全:133,000+ 个条目全部安全分级、质量评分,每 8 小时刷新。</p>
-
- <h2>English copy</h2>
- <p class="copy"><strong>Agent Skills Hub</strong> — Find Claude skills &amp; MCP servers without guessing what's safe. Every one of 133,000+ entries is security-graded, quality-scored, and refreshed every 8 hours.</p>
-
- <h2>验收</h2>
- <p>确认两个 README 的链接均为 <code>https://agentskillshub.top/</code>,中文与英文信息一致,Markdown 格式检查通过,完整测试通过,并只提交本次相关文件。</p>
- </main>
-</body>
-</html>
diff --git a/.openteams/specs/2026-08-04-readme-partner-section-design.html b/.openteams/specs/2026-08-04-readme-partner-section-design.html
deleted file mode 100644
index 6bc76fc7..00000000
--- a/.openteams/specs/2026-08-04-readme-partner-section-design.html
+++ /dev/null
@@ -1,123 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-<head>
- <meta charset="utf-8">
- <meta name="viewport" content="width=device-width, initial-scale=1">
- <title>Agent Reach README 赞助与友链区域调整</title>
- <style>
- :root {
- color-scheme: light dark;
- --bg: #f6f7fb;
- --card: #ffffff;
- --text: #20242c;
- --muted: #626a78;
- --line: #dfe3ea;
- --accent: #d64f70;
- --accent-soft: #fff0f4;
- }
- @media (prefers-color-scheme: dark) {
- :root {
- --bg: #14161b;
- --card: #1d2027;
- --text: #f2f3f5;
- --muted: #aeb4bf;
- --line: #343944;
- --accent-soft: #351f28;
- }
- }
- * { box-sizing: border-box; }
- body {
- margin: 0;
- background: var(--bg);
- color: var(--text);
- font: 16px/1.65 -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
- }
- main { max-width: 920px; margin: 48px auto; padding: 0 24px 64px; }
- header, section {
- background: var(--card);
- border: 1px solid var(--line);
- border-radius: 16px;
- padding: 28px 32px;
- margin-bottom: 18px;
- }
- h1, h2 { line-height: 1.25; margin-top: 0; }
- h1 { font-size: 30px; margin-bottom: 8px; }
- h2 { font-size: 20px; }
- p:last-child { margin-bottom: 0; }
- .eyebrow { color: var(--accent); font-weight: 700; letter-spacing: .05em; }
- .muted { color: var(--muted); }
- .flow { display: grid; gap: 10px; }
- .step {
- border-left: 4px solid var(--accent);
- background: var(--accent-soft);
- border-radius: 8px;
- padding: 12px 16px;
- }
- table { width: 100%; border-collapse: collapse; }
- th, td { border-bottom: 1px solid var(--line); padding: 12px; text-align: left; vertical-align: top; }
- th { color: var(--muted); font-size: 14px; }
- code { background: var(--accent-soft); border-radius: 5px; padding: 2px 6px; }
- ul { padding-left: 22px; }
- </style>
-</head>
-<body>
-<main>
- <header>
- <div class="eyebrow">README DESIGN · 2026-08-04</div>
- <h1>赞助与友链区域调整</h1>
- <p class="muted">把商业合作集中到 README 顶部,同时保留生态友链的真实身份,避免正文中出现孤立广告。</p>
- </header>
-
- <section>
- <h2>目标与边界</h2>
- <ul>
- <li>让赞助内容在顶部清晰可见,但不影响项目核心介绍。</li>
- <li>BrowserAct、腾讯云 OpenClaw、CoreClaw 与星图 AstraFlow 使用统一的左右两列赞助条目。</li>
- <li>Agent Skills Hub 与 AtomGit 镜像保留在 README 最后的「友情链接」。</li>
- <li>方舟 Agent Plan 从 README 中删除。</li>
- <li>不改产品能力、安装流程、Python 代码或上游项目。</li>
- </ul>
- </section>
-
- <section>
- <h2>页面结构</h2>
- <div class="flow">
- <div class="step">项目标题、简介、徽章、语言与页面导航</div>
- <div class="step"><strong>❤️ 赞助商</strong>:默认展开的折叠区,展示 BrowserAct、腾讯云 OpenClaw、CoreClaw 与星图 AstraFlow</div>
- <div class="step">为什么需要 Agent Reach、平台能力、安装与设计理念等正文</div>
- <div class="step"><strong>友情链接</strong>:Agent Skills Hub 与 AtomGit 镜像</div>
- <div class="step">Star History</div>
- </div>
- </section>
-
- <section>
- <h2>赞助区呈现</h2>
- <table>
- <thead><tr><th>元素</th><th>约定</th></tr></thead>
- <tbody>
- <tr><td>位置</td><td>顶部导航之后、第一段产品正文之前。</td></tr>
- <tr><td>容器</td><td>使用 <code>&lt;details open&gt;</code>,允许折叠但默认展示。</td></tr>
- <tr><td>布局</td><td>所有合作方统一使用 HTML 表格;左侧固定宽度小图,右侧为项目说明和链接。</td></tr>
- <tr><td>素材</td><td>仅使用合作方官方 Logo,保存到 <code>docs/assets/sponsors/</code>。</td></tr>
- <tr><td>文案</td><td>沿用现有事实,不新增未经确认的优惠、承诺或夸张表述。</td></tr>
- </tbody>
- </table>
- </section>
-
- <section>
- <h2>文件范围与验证</h2>
- <ul>
- <li>同步修改 <code>README.md</code> 与 <code>docs/README_en.md</code>。</li>
- <li>删除中部 BrowserAct 独立段落,确保全文不再重复。</li>
- <li>检查图片路径、链接、HTML 标签闭合和中英文内容对应关系。</li>
- <li>通过文本扫描确认方舟 Agent Plan 已移除,四个保留项目各自只出现在预定区域。</li>
- </ul>
- </section>
-
- <section>
- <h2>提交记录</h2>
- <p>提交信息只描述本项目自身变化:<code>docs(readme): reorganize partner section</code>。不在提交、分支或 README 中记录外部版式参考来源。</p>
- </section>
-</main>
-</body>
-</html>
diff --git a/config/mcporter.json b/config/mcporter.json
deleted file mode 100644
index 82a7b98b..00000000
--- a/config/mcporter.json
+++ /dev/null
@@ -1,11 +0,0 @@
-{
- "mcpServers": {
- "exa": {
- "baseUrl": "https://mcp.exa.ai/mcp"
- },
- "xiaohongshu": {
- "baseUrl": "http://localhost:18060/mcp"
- }
- },
- "imports": []
-}
diff --git a/constraints.txt b/constraints.txt
index 20fb6d39..1cefa184 100644
--- a/constraints.txt
+++ b/constraints.txt
@@ -4,7 +4,6 @@
requests==2.32.5
feedparser==6.0.12
-python-dotenv==1.2.1
loguru==0.7.3
PyYAML==6.0.3
rich==14.3.2
diff --git a/pyproject.toml b/pyproject.toml
index 919f2a19..fb7a29a5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -30,7 +30,6 @@ classifiers = [
dependencies = [
"requests>=2.28",
"feedparser>=6.0",
- "python-dotenv>=1.0",
"loguru>=0.7",
"pyyaml>=6.0",
"rich>=13.0",
diff --git a/scripts/sync-upstream.sh b/scripts/sync-upstream.sh
deleted file mode 100755
index b5710f3b..00000000
--- a/scripts/sync-upstream.sh
+++ /dev/null
@@ -1,72 +0,0 @@
-#!/bin/bash
-# sync-upstream.sh — Sync channel implementations from upstream tools
-#
-# Usage: ./scripts/sync-upstream.sh
-#
-# This script checks for updates in x-reader's fetchers/ directory
-# and shows which files have changed. You can then manually review
-# and merge the changes.
-
-set -e
-
-UPSTREAM_REPO="runesleo/x-reader"
-UPSTREAM_BRANCH="main"
-UPSTREAM_DIR="x_reader/fetchers"
-LOCAL_DIR="agent_reach/channels"
-
-echo "👁️ Agent Reach — Upstream Sync"
-echo "Checking for updates from $UPSTREAM_REPO..."
-echo ""
-
-# Create temp dir for upstream code
-TMPDIR=$(mktemp -d)
-trap "rm -rf $TMPDIR" EXIT
-
-# Clone upstream (shallow)
-git clone --depth 1 --branch "$UPSTREAM_BRANCH" \
- "https://github.com/$UPSTREAM_REPO.git" "$TMPDIR/upstream" 2>/dev/null
-
-if [ ! -d "$TMPDIR/upstream/$UPSTREAM_DIR" ]; then
- echo "❌ Upstream directory not found: $UPSTREAM_DIR"
- echo " x-reader may have changed their structure."
- exit 1
-fi
-
-# Compare each file
-echo "Comparing files..."
-echo ""
-
-CHANGES=0
-for upstream_file in "$TMPDIR/upstream/$UPSTREAM_DIR"/*.py; do
- filename=$(basename "$upstream_file")
- local_file="$LOCAL_DIR/$filename"
-
- if [ ! -f "$local_file" ]; then
- echo "🆕 NEW: $filename (exists in upstream but not locally)"
- CHANGES=$((CHANGES + 1))
- continue
- fi
-
- # Compare (ignoring import path differences)
- if ! diff -q <(sed 's/x_reader\.fetchers/agent_reach.channels/g' "$upstream_file") "$local_file" > /dev/null 2>&1; then
- echo "📝 CHANGED: $filename"
- diff --color -u <(sed 's/x_reader\.fetchers/agent_reach.channels/g' "$upstream_file") "$local_file" | head -20
- echo " ..."
- echo ""
- CHANGES=$((CHANGES + 1))
- fi
-done
-
-if [ $CHANGES -eq 0 ]; then
- echo "✅ All channels are up to date with upstream!"
-else
- echo ""
- echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
- echo "$CHANGES file(s) have upstream changes."
- echo ""
- echo "To merge a specific file:"
- echo " cp $TMPDIR/upstream/$UPSTREAM_DIR/FILENAME.py $LOCAL_DIR/FILENAME.py"
- echo " sed -i 's/x_reader\\.fetchers/agent_reach.channels/g' $LOCAL_DIR/FILENAME.py"
- echo ""
- echo "Then review changes, run tests, and commit."
-fi