diff --git a/skills/opencli-explorer/SKILL.md b/skills/opencli-explorer/SKILL.md index 4d68faa2..e59fb298 100644 --- a/skills/opencli-explorer/SKILL.md +++ b/skills/opencli-explorer/SKILL.md @@ -1,3 +1,9 @@ +--- +name: opencli-explorer +description: Use when creating a new OpenCLI adapter from scratch, adding support for a new website or platform, or exploring a site's API endpoints via browser DevTools. Covers API discovery workflow, authentication strategy selection, YAML/TS adapter writing, and testing. +tags: [opencli, adapter, browser, api-discovery, cli, web-scraping, automation] +--- + # CLI-EXPLORER — 适配器探索式开发完全指南 > 本文档教你（或 AI Agent）如何为 OpenCLI 添加一个新网站的命令。 diff --git a/skills/opencli-oneshot/SKILL.md b/skills/opencli-oneshot/SKILL.md index bc2f71ba..c3419380 100644 --- a/skills/opencli-oneshot/SKILL.md +++ b/skills/opencli-oneshot/SKILL.md @@ -1,3 +1,9 @@ +--- +name: opencli-oneshot +description: Use when quickly generating a single OpenCLI command from a specific URL and goal description. 4-step process — open page, capture API, write YAML adapter, test. For full site exploration, use opencli-explorer instead. +tags: [opencli, adapter, quick-start, yaml, cli, one-shot, automation] +--- + # CLI-ONESHOT — 单点快速 CLI 生成 > 给一个 URL + 一句话描述，4 步生成一个 CLI 命令。 diff --git a/skills/opencli-usage/SKILL.md b/skills/opencli-usage/SKILL.md index 925b73a4..2fb4c847 100644 --- a/skills/opencli-usage/SKILL.md +++ b/skills/opencli-usage/SKILL.md @@ -1,9 +1,9 @@ --- name: opencli-usage -description: "OpenCLI usage guide — installation, prerequisites, and command reference organized by platform" +description: "Use when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion), or public APIs (HackerNews, arXiv). Covers installation, command reference, and output formats for 60+ adapters." version: 1.5.9 author: jackwener -tags: [cli, browser, web, chrome-extension, cdp, AI, agent] +tags: [opencli, cli, browser, web, chrome-extension, cdp, bilibili, twitter, reddit, xiaohongshu, github, youtube, AI, agent, automation] --- # OpenCLI Usage Guide @@ -36,36 +36,117 @@ Browser commands require: Public API commands (`hackernews`, `v2ex`) need no browser. -## Command Categories +## Quick Lookup by Capability + +| Capability | Platforms (partial list) | File | +|-----------|--------------------------|------| +| **search** | Bilibili, Twitter, Reddit, Xiaohongshu, Zhihu, YouTube, Google, arXiv, LinkedIn, Pixiv, etc. | browser.md / public-api.md | +| **hot/trending** | Bilibili, Twitter, Weibo, HackerNews, Reddit, V2EX, Xueqiu, Lobsters, Douban | browser.md / public-api.md | +| **feed/timeline** | Twitter, Reddit, Xiaohongshu, Xueqiu, Jike, Facebook, Instagram, Medium | browser.md | +| **user/profile** | Twitter, Reddit, Instagram, TikTok, Facebook, Bilibili, Pixiv | browser.md | +| **post/create** | Twitter, Jike | browser.md | +| **AI chat** | Grok, Doubao, Kimi, DeepSeek, Qwen, ChatGPT, Cursor, Codex | browser.md / desktop.md | +| **finance/stock** | Xueqiu, Yahoo Finance, Barchart, Sina Finance, Bloomberg | browser.md / public-api.md | +| **web scraping** | `opencli web read --url ` — any URL to Markdown | browser.md | + +## Command Quick Reference + +Usage: `opencli [args] [--limit N] [-f json|yaml|md|csv|table]` + +### Browser-based (login required) + +| Site | Commands | +|------|----------| +| **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `user-videos` `subtitle` `dynamic` `ranking` `following` | +| **zhihu** | `hot` `search` `question` | +| **xiaohongshu** | `search` `notifications` `feed` `user` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | +| **xueqiu** | `hot-stock` `stock` `watchlist` `feed` `hot` `search` `earnings-date` `fund-holdings` `fund-snapshot` | +| **twitter** | `trending` `bookmarks` `search` `profile` `timeline` `thread` `article` `follow` `unfollow` `bookmark` `unbookmark` `post` `like` `reply` `delete` `block` `unblock` `followers` `following` `notifications` `hide-reply` `download` `accept` `reply-dm` | +| **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | +| **youtube** | `search` `video` `transcript` | +| **facebook** | `feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group` | +| **instagram** | `explore` `profile` `search` `user` `followers` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `saved` | +| **tiktok** | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` | +| **linkedin** | `search` `timeline` | +| **medium** | `feed` `search` `user` | +| **substack** | `feed` `search` `publication` | +| **sinablog** | `hot` `search` `article` `user` | +| **weibo** | `hot` | +| **boss** | `search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats` | +| **douban** | `search` `top250` `subject` `photos` `download` `marks` `reviews` | +| **pixiv** | `ranking` `search` `user` `illusts` `detail` `download` | +| **jike** | `feed` `search` `create` `like` `comment` `repost` `notifications` | +| **yahoo-finance** | `quote` | +| **barchart** | `quote` `options` `greeks` `flow` | +| **sinafinance** | `news` | +| **reuters** | `search` | +| **coupang** | `search` `add-to-cart` | +| **jd** | `item` | +| **smzdm** | `search` | +| **ctrip** | `search` | +| **weread** | `shelf` `search` `book` `highlights` `notes` `ranking` | +| **chaoxing** | `assignments` `exams` | +| **jimeng** | `generate` `history` | +| **yollomi** | `models` `generate` `video` `upload` `remove-bg` `edit` `background` `face-swap` `object-remover` `restore` `try-on` `upscale` | +| **web** | `read` — any URL to Markdown | +| **weixin** | `download` — 公众号 article to Markdown | +| **v2ex** (browser) | `daily` `me` `notifications` | +| **linux-do** (browser) | `categories` `category` | +| **bloomberg** (browser) | `news` — full article reader | +| **grok** | `ask` | +| **doubao** | `status` `new` `send` `read` `ask` | +| **kimi** | `status` `new` `ask` | +| **deepseek** | `status` `new` `ask` | +| **qwen** | `status` `new` `ask` | + +### Desktop (CDP/Electron) + +| Site | Commands | +|------|----------| +| **gh** | `repo` `pr` `issue` — passthrough to gh CLI | +| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` | +| **codex** | `status` `send` `read` `new` `dump` `extract-diff` `model` `ask` `screenshot` `history` `export` | +| **chatgpt** | `status` `new` `send` `read` `ask` | +| **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` | +| **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` | +| **discord-app** | `status` `send` `read` `channels` `servers` `search` `members` | +| **doubao-app** | `status` `new` `send` `read` `ask` `screenshot` `dump` | +| **antigravity** | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` | + +### Public API (no browser) + +| Site | Commands | +|------|----------| +| **hackernews** | `top` `new` `best` `ask` `show` `jobs` `search` `user` | +| **v2ex** (public) | `hot` `latest` `topic` `node` `nodes` `member` `user` `replies` | +| **bbc** | `news` | +| **lobsters** | `hot` `newest` `active` `tag` | +| **google** | `news` `search` `suggest` `trends` | +| **devto** | `top` `tag` `user` | +| **steam** | `top-sellers` | +| **apple-podcasts** | `top` `search` `episodes` | +| **arxiv** | `search` `paper` | +| **bloomberg** (RSS) | `main` `markets` `tech` `politics` `economics` `opinions` `industries` `businessweek` `feeds` | +| **dictionary** | `search` `synonyms` `examples` | +| **hf** | `top` | +| **stackoverflow** | `hot` `search` `bounties` | +| **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` | +| **wikipedia** | `search` `summary` | +| **producthunt** | `today` `week` `month` `search` | + +### Management -OpenCLI commands are organized by platform type: - -### 📱 Browser-based Commands -Commands that require Chrome browser with login state. See [browser.md](./browser.md) for full reference. - -**Supported platforms:** -- Bilibili (哔哩哔哩), Zhihu (知乎), Xiaohongshu (小红书), Xueqiu (雪球) -- Twitter/X, Reddit, Facebook, Instagram, TikTok, LinkedIn -- YouTube, Medium, Substack, Sinablog (新浪博客) -- V2EX (browser features), Weibo (微博), Jike (即刻), Linux.do (browser features) -- BOSS直聘, Coupang (쿠팡), JD (京东), SMZDM (什么值得买), Ctrip (携程) -- Yahoo Finance, Sina Finance, Reuters, Barchart, Bloomberg (full article) -- Douban (豆瓣), Chaoxing (超星学习通), WeRead (微信读书), Pixiv -- Yollomi, Jimeng (即梦 AI), Web, Weixin (微信公众号) -- Grok, Doubao Web (豆包), Kimi, DeepSeek, Qwen (通义千问) - -### 🖥️ Desktop Adapter Commands -Commands that interact with desktop applications via CDP or external CLI tools. See [desktop.md](./desktop.md) for full reference. +```bash +opencli list [-f json|yaml] # List all commands +opencli validate [site] # Validate adapter definitions +opencli doctor # Diagnose browser bridge +opencli explore # AI-powered API discovery +opencli record # Record API calls manually +``` -**Supported platforms:** -- GitHub (via gh CLI), Cursor, Codex, ChatGPT, ChatWise -- Notion, Discord App, Doubao App (豆包桌面版), Antigravity +All commands support: `--format` / `-f` with `table` `json` `yaml` `md` `csv` -### 🌐 Public API Commands -Commands that work without browser or authentication. See [public-api.md](./public-api.md) for full reference. +## Related Skills -**Supported platforms:** -- Hacker News, V2EX (public features), BBC News, Sina Finance -- Lobsters, Google, DEV.to, Steam, Apple Podcasts -- arXiv, Bloomberg (RSS), Dictionary, HuggingFace -- StackOverflow, Xiaoyuzhou (小宇宙), Wikipedia, Product Hunt +- **opencli-explorer** — Full guide for creating new adapters (API discovery, auth strategy, YAML/TS writing) +- **opencli-oneshot** — Quick 4-step template for adding a single command from a URL