| name | mkt-xcom-viral-knowledge-finder |
| description | Tìm các bài đăng viral trên X.com (Twitter) về Claude.ai và các chủ đề AI đang hot — tập trung vào dạng bài CHIA SẺ KIẾN THỨC (threads, tips, tutorials, frameworks, how-tos) thay vì hype/news. Dùng Grok model qua OpenRouter API để search và lọc. USE WHEN user says 'tìm bài viral claude', 'viral x post claude', 'find viral x posts about AI', 'tìm thread AI hay', 'x.com knowledge posts', 'tìm post chia sẻ kiến thức claude', 'viral tweet AI', 'tweet AI hot', 'thread claude ai viral', 'x trending claude', 'grok search x posts', 'knowledge tweet', 'AI thread trending', 'viral knowledge x'. |
X.com Viral Knowledge Finder (Claude.ai / AI Topics)
Tìm top viral posts trên X.com mang tính chia sẻ kiến thức (thread, tips, frameworks, tutorials, workflow) về Claude.ai hoặc các chủ đề AI đang hot. Dùng Grok via OpenRouter (không phải xAI API trực tiếp) để research.
Phân biệt với skill khác:
mkt-ai-news-aggregator/search_x_posts.py — news/trending tổng hợp, dùng xAI API trực tiếp- Skill này — chỉ knowledge-sharing, ưu tiên threads dài, tutorial, tips có value để repurpose thành content
When to Use
- User muốn tìm thread X.com hay về Claude.ai để học/repurpose
- Cần seed content cho Pillar 1 (AI Demo/Tutorial) từ nguồn X
- Tìm góc nhìn mới về AI agent, prompt engineering, workflow
- Research trước khi viết script/post về 1 chủ đề AI
Không dùng khi:
- Chỉ cần tin tức nhanh → dùng
mkt-ai-news-aggregator
- Cần data chuyên về repo/tool → dùng
github-trend-finder
Prerequisites
.env cần có:
OPENROUTER_API_KEY=sk-or-...
Dependency: requests, python-dotenv (auto-install qua uv run).
Usage
uv run .claude/skills/mkt-xcom-viral-knowledge-finder/scripts/search_x_viral_knowledge.py
uv run .claude/skills/mkt-xcom-viral-knowledge-finder/scripts/search_x_viral_knowledge.py \
--topic "claude code agent" --period week --limit 15
uv run .claude/skills/mkt-xcom-viral-knowledge-finder/scripts/search_x_viral_knowledge.py \
--topic "AI agent frameworks" --model "x-ai/grok-4"
uv run .claude/skills/mkt-xcom-viral-knowledge-finder/scripts/search_x_viral_knowledge.py \
--topic "prompt engineering" --format text
uv run .claude/skills/mkt-xcom-viral-knowledge-finder/scripts/search_x_viral_knowledge.py --no-save
Options
| Flag | Default | Mô tả |
|---|
--topic | Claude.ai | Chủ đề cần tìm (e.g. "claude code", "AI agent", "prompt engineering") |
--period | week | 24h | week | month |
--limit | 10 | Số post tối đa |
--model | x-ai/grok-4-fast | Model ID trên OpenRouter (gợi ý: x-ai/grok-4-fast, x-ai/grok-4, x-ai/grok-2-1212) |
--output-dir | research/x-viral-knowledge/[YYYY-MM-DD]/ | Thư mục output |
--format | json | json | text |
--no-save | — | Không lưu file, chỉ stdout |
Output
Type: research
Location: research/x-viral-knowledge/[YYYY-MM-DD]/
Files produced:
viral-knowledge-[topic-slug]-[period].json — Raw dataviral-knowledge-[topic-slug]-[period].md — Summary + chi tiết từng post
JSON schema (mỗi item):
{
"rank": 1,
"author": "@handle",
"post_type": "thread|single|quote",
"title_or_hook": "Dòng đầu / headline của post",
"summary": "Tóm tắt 3-5 câu nội dung kiến thức chính",
"key_takeaways": ["tip 1", "tip 2", "tip 3"],
"knowledge_value": 9,
"virality_signal": "high|medium|low",
"url": "https://x.com/...",
"tags": ["claude", "prompt", "agent"]
}
Trường knowledge_value (1-10) ước lượng mức độ giá trị kiến thức, dùng để rank downstream.
Workflow khi nhận yêu cầu
Bước 1: Xác định topic
Nếu user không nói cụ thể → default Claude.ai. Nếu user nói "AI hot" → topic rộng như AI agent / AI coding.
Bước 2: Chạy script
uv run .claude/skills/mkt-xcom-viral-knowledge-finder/scripts/search_x_viral_knowledge.py \
--topic "<topic>" --period <period> --limit <n>
Bước 3: Trình bày top list
Tóm tắt cho user:
rank. @author [knowledge_value/10] — title_or_hook- Key takeaways dạng bullet
- Link X.com (nếu có)
Ưu tiên post có knowledge_value >= 7 và post_type = thread.
Bước 4: Gợi ý content (tùy chọn)
Với mỗi post chất lượng → suggest:
- Pillar 1: Repurpose thread thành video tutorial Việt hóa
- Pillar 3: "Tuần này trên X có gì hay về Claude" — tổng hợp list
- Facebook post:
mkt-xpost-to-facebook-knowledge để convert thẳng sang bài Facebook
Filtering Rules (built-in)
Script prompt Grok chỉ trả về posts thỏa mãn:
- Loại bỏ: pure news ("OpenAI releases X"), memes, shitposts, hype without substance, ads, affiliate spam
- Giữ lại: threads giải thích concept, tips/tricks actionable, workflow breakdowns, comparison/review có phân tích, prompt templates, case studies với learnings cụ thể
Quality Criteria
GOOD output:
BAD output:
Integration với skills khác
| Downstream | Cách dùng |
|---|
mkt-xpost-to-facebook-knowledge | Convert 1 post → bài Facebook tiếng Việt |
mkt-content-repurposer | 1 thread dài → multi-format content |
mkt-news-to-content-brief | Rank list theo audience relevance |
mkt-create-script-short-video-v2-vn | Pick 1 tip → viết script ngắn |
mkt-content-knowledge-compiler | Compile insights vào knowledge base |
Troubleshooting
| Lỗi | Nguyên nhân | Giải pháp |
|---|
OPENROUTER_API_KEY not set | Thiếu env | Thêm vào .env |
HTTP 401 | Key sai / hết credit | Check OpenRouter dashboard |
HTTP 404 model_not_found | Model ID không hợp lệ | Thử --model x-ai/grok-2-1212 |
| Items toàn news chứ không phải knowledge | Grok không phân biệt tốt | Thêm từ khóa cụ thể hơn ("thread", "tutorial", "how to") vào --topic |
| JSON parse fail | Grok trả plain text | Script tự fallback, re-run hoặc đổi model |
| Kết quả lặp lại giữa các lần chạy | Grok không có live X search qua OpenRouter — dựa vào training/web | Dùng mkt-ai-news-aggregator/search_x_posts.py (xAI API trực tiếp) cho real-time |
Giới hạn quan trọng
Grok qua OpenRouter KHÔNG có X real-time search tool như khi gọi xAI API trực tiếp. Kết quả dựa trên:
- Training data của Grok
- Knowledge được cập nhật trong model
- Reasoning về topic
→ Nếu cần real-time trending posts → dùng mkt-ai-news-aggregator/scripts/search_x_posts.py (xAI direct).
→ Skill này phù hợp khi cần curated knowledge có chiều sâu, không cần ngay hôm nay.
Scripts
scripts/search_x_viral_knowledge.py — Main search script qua OpenRouter → Grok.
