@jackwener/opencli 0.9.6 → 0.9.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.yml +83 -0
  2. package/.github/ISSUE_TEMPLATE/config.yml +8 -0
  3. package/.github/ISSUE_TEMPLATE/feature_request.yml +42 -0
  4. package/.github/ISSUE_TEMPLATE/new_site_adapter.yml +57 -0
  5. package/.github/dependabot.yml +27 -0
  6. package/.github/pull_request_template.md +24 -0
  7. package/.github/workflows/ci.yml +14 -8
  8. package/.github/workflows/e2e-headed.yml +6 -2
  9. package/.github/workflows/pkg-pr-new.yml +2 -2
  10. package/.github/workflows/release-please.yml +25 -0
  11. package/.github/workflows/release.yml +2 -2
  12. package/.github/workflows/security.yml +36 -0
  13. package/CLI-ELECTRON.md +89 -36
  14. package/CONTRIBUTING.md +167 -0
  15. package/README.md +98 -32
  16. package/README.zh-CN.md +99 -33
  17. package/dist/browser/discover.js +22 -7
  18. package/dist/browser.test.js +23 -0
  19. package/dist/build-manifest.d.ts +26 -0
  20. package/dist/build-manifest.js +132 -60
  21. package/dist/build-manifest.test.d.ts +1 -0
  22. package/dist/build-manifest.test.js +26 -0
  23. package/dist/cli-manifest.json +1415 -29
  24. package/dist/clis/bilibili/download.d.ts +10 -0
  25. package/dist/clis/bilibili/download.js +135 -0
  26. package/dist/clis/chatwise/ask.d.ts +1 -0
  27. package/dist/clis/chatwise/ask.js +76 -0
  28. package/dist/clis/chatwise/export.d.ts +1 -0
  29. package/dist/clis/chatwise/export.js +46 -0
  30. package/dist/clis/chatwise/history.d.ts +1 -0
  31. package/dist/clis/chatwise/history.js +43 -0
  32. package/dist/clis/chatwise/model.d.ts +1 -0
  33. package/dist/clis/chatwise/model.js +81 -0
  34. package/dist/clis/chatwise/new.d.ts +1 -0
  35. package/dist/clis/chatwise/new.js +18 -0
  36. package/dist/clis/chatwise/read.d.ts +1 -0
  37. package/dist/clis/chatwise/read.js +39 -0
  38. package/dist/clis/chatwise/screenshot.d.ts +1 -0
  39. package/dist/clis/chatwise/screenshot.js +27 -0
  40. package/dist/clis/chatwise/send.d.ts +1 -0
  41. package/dist/clis/chatwise/send.js +45 -0
  42. package/dist/clis/chatwise/status.d.ts +1 -0
  43. package/dist/clis/chatwise/status.js +22 -0
  44. package/dist/clis/discord-app/channels.d.ts +1 -0
  45. package/dist/clis/discord-app/channels.js +45 -0
  46. package/dist/clis/discord-app/members.d.ts +1 -0
  47. package/dist/clis/discord-app/members.js +38 -0
  48. package/dist/clis/discord-app/read.d.ts +1 -0
  49. package/dist/clis/discord-app/read.js +45 -0
  50. package/dist/clis/discord-app/search.d.ts +1 -0
  51. package/dist/clis/discord-app/search.js +56 -0
  52. package/dist/clis/discord-app/send.d.ts +1 -0
  53. package/dist/clis/discord-app/send.js +27 -0
  54. package/dist/clis/discord-app/servers.d.ts +1 -0
  55. package/dist/clis/discord-app/servers.js +36 -0
  56. package/dist/clis/discord-app/status.d.ts +1 -0
  57. package/dist/clis/discord-app/status.js +16 -0
  58. package/dist/clis/feishu/new.d.ts +1 -0
  59. package/dist/clis/feishu/new.js +27 -0
  60. package/dist/clis/feishu/read.d.ts +1 -0
  61. package/dist/clis/feishu/read.js +40 -0
  62. package/dist/clis/feishu/search.d.ts +1 -0
  63. package/dist/clis/feishu/search.js +30 -0
  64. package/dist/clis/feishu/send.d.ts +1 -0
  65. package/dist/clis/feishu/send.js +39 -0
  66. package/dist/clis/feishu/status.d.ts +1 -0
  67. package/dist/clis/feishu/status.js +28 -0
  68. package/dist/clis/grok/ask.d.ts +1 -0
  69. package/dist/clis/grok/ask.js +82 -0
  70. package/dist/clis/grok/debug.d.ts +1 -0
  71. package/dist/clis/grok/debug.js +45 -0
  72. package/dist/clis/jimeng/generate.yaml +84 -0
  73. package/dist/clis/jimeng/history.yaml +47 -0
  74. package/dist/clis/linux-do/categories.yaml +41 -0
  75. package/dist/clis/linux-do/category.yaml +49 -0
  76. package/dist/clis/linux-do/hot.yaml +50 -0
  77. package/dist/clis/linux-do/latest.yaml +40 -0
  78. package/dist/clis/linux-do/search.yaml +45 -0
  79. package/dist/clis/linux-do/topic.yaml +38 -0
  80. package/dist/clis/notion/export.d.ts +1 -0
  81. package/dist/clis/notion/export.js +31 -0
  82. package/dist/clis/notion/favorites.d.ts +1 -0
  83. package/dist/clis/notion/favorites.js +84 -0
  84. package/dist/clis/notion/new.d.ts +1 -0
  85. package/dist/clis/notion/new.js +34 -0
  86. package/dist/clis/notion/read.d.ts +1 -0
  87. package/dist/clis/notion/read.js +30 -0
  88. package/dist/clis/notion/search.d.ts +1 -0
  89. package/dist/clis/notion/search.js +46 -0
  90. package/dist/clis/notion/sidebar.d.ts +1 -0
  91. package/dist/clis/notion/sidebar.js +41 -0
  92. package/dist/clis/notion/status.d.ts +1 -0
  93. package/dist/clis/notion/status.js +16 -0
  94. package/dist/clis/notion/write.d.ts +1 -0
  95. package/dist/clis/notion/write.js +40 -0
  96. package/dist/clis/twitter/download.d.ts +8 -0
  97. package/dist/clis/twitter/download.js +204 -0
  98. package/dist/clis/wechat/chats.d.ts +1 -0
  99. package/dist/clis/wechat/chats.js +28 -0
  100. package/dist/clis/wechat/contacts.d.ts +1 -0
  101. package/dist/clis/wechat/contacts.js +28 -0
  102. package/dist/clis/wechat/read.d.ts +1 -0
  103. package/dist/clis/wechat/read.js +58 -0
  104. package/dist/clis/wechat/search.d.ts +1 -0
  105. package/dist/clis/wechat/search.js +31 -0
  106. package/dist/clis/wechat/send.d.ts +1 -0
  107. package/dist/clis/wechat/send.js +42 -0
  108. package/dist/clis/wechat/status.d.ts +1 -0
  109. package/dist/clis/wechat/status.js +29 -0
  110. package/dist/clis/xiaohongshu/creator-note-detail.d.ts +10 -0
  111. package/dist/clis/xiaohongshu/creator-note-detail.js +88 -0
  112. package/dist/clis/xiaohongshu/creator-notes.d.ts +11 -0
  113. package/dist/clis/xiaohongshu/creator-notes.js +109 -0
  114. package/dist/clis/xiaohongshu/creator-profile.d.ts +10 -0
  115. package/dist/clis/xiaohongshu/creator-profile.js +54 -0
  116. package/dist/clis/xiaohongshu/creator-stats.d.ts +10 -0
  117. package/dist/clis/xiaohongshu/creator-stats.js +74 -0
  118. package/dist/clis/xiaohongshu/download.d.ts +7 -0
  119. package/dist/clis/xiaohongshu/download.js +155 -0
  120. package/dist/clis/xiaohongshu/search.js +1 -1
  121. package/dist/clis/xiaohongshu/user-helpers.d.ts +15 -0
  122. package/dist/clis/xiaohongshu/user-helpers.js +67 -0
  123. package/dist/clis/xiaohongshu/user-helpers.test.d.ts +1 -0
  124. package/dist/clis/xiaohongshu/user-helpers.test.js +81 -0
  125. package/dist/clis/xiaohongshu/user.js +46 -29
  126. package/dist/clis/zhihu/download.d.ts +11 -0
  127. package/dist/clis/zhihu/download.js +186 -0
  128. package/dist/clis/zhihu/download.test.d.ts +1 -0
  129. package/dist/clis/zhihu/download.test.js +10 -0
  130. package/dist/download/index.d.ts +79 -0
  131. package/dist/download/index.js +325 -0
  132. package/dist/download/progress.d.ts +36 -0
  133. package/dist/download/progress.js +111 -0
  134. package/dist/engine.test.js +15 -0
  135. package/dist/main.js +16 -3
  136. package/dist/pipeline/registry.js +2 -0
  137. package/dist/pipeline/steps/download.d.ts +34 -0
  138. package/dist/pipeline/steps/download.js +251 -0
  139. package/dist/pipeline/template.js +28 -0
  140. package/package.json +4 -3
  141. package/scripts/test-site.mjs +70 -0
  142. package/src/browser/discover.ts +23 -7
  143. package/src/browser.test.ts +23 -0
  144. package/src/build-manifest.test.ts +28 -0
  145. package/src/build-manifest.ts +147 -57
  146. package/src/clis/bilibili/download.ts +161 -0
  147. package/src/clis/chatwise/README.md +38 -0
  148. package/src/clis/chatwise/README.zh-CN.md +38 -0
  149. package/src/clis/chatwise/ask.ts +87 -0
  150. package/src/clis/chatwise/export.ts +51 -0
  151. package/src/clis/chatwise/history.ts +47 -0
  152. package/src/clis/chatwise/model.ts +87 -0
  153. package/src/clis/chatwise/new.ts +21 -0
  154. package/src/clis/chatwise/read.ts +42 -0
  155. package/src/clis/chatwise/screenshot.ts +33 -0
  156. package/src/clis/chatwise/send.ts +50 -0
  157. package/src/clis/chatwise/status.ts +25 -0
  158. package/src/clis/discord-app/README.md +28 -0
  159. package/src/clis/discord-app/README.zh-CN.md +28 -0
  160. package/src/clis/discord-app/channels.ts +48 -0
  161. package/src/clis/discord-app/members.ts +41 -0
  162. package/src/clis/discord-app/read.ts +49 -0
  163. package/src/clis/discord-app/search.ts +64 -0
  164. package/src/clis/discord-app/send.ts +32 -0
  165. package/src/clis/discord-app/servers.ts +39 -0
  166. package/src/clis/discord-app/status.ts +18 -0
  167. package/src/clis/feishu/README.md +20 -0
  168. package/src/clis/feishu/README.zh-CN.md +20 -0
  169. package/src/clis/feishu/new.ts +32 -0
  170. package/src/clis/feishu/read.ts +48 -0
  171. package/src/clis/feishu/search.ts +35 -0
  172. package/src/clis/feishu/send.ts +46 -0
  173. package/src/clis/feishu/status.ts +34 -0
  174. package/src/clis/grok/ask.ts +90 -0
  175. package/src/clis/grok/debug.ts +49 -0
  176. package/src/clis/jimeng/generate.yaml +84 -0
  177. package/src/clis/jimeng/history.yaml +47 -0
  178. package/src/clis/linux-do/categories.yaml +41 -0
  179. package/src/clis/linux-do/category.yaml +49 -0
  180. package/src/clis/linux-do/hot.yaml +50 -0
  181. package/src/clis/linux-do/latest.yaml +40 -0
  182. package/src/clis/linux-do/search.yaml +45 -0
  183. package/src/clis/linux-do/topic.yaml +38 -0
  184. package/src/clis/notion/README.md +29 -0
  185. package/src/clis/notion/README.zh-CN.md +29 -0
  186. package/src/clis/notion/export.ts +36 -0
  187. package/src/clis/notion/favorites.ts +87 -0
  188. package/src/clis/notion/new.ts +39 -0
  189. package/src/clis/notion/read.ts +33 -0
  190. package/src/clis/notion/search.ts +54 -0
  191. package/src/clis/notion/sidebar.ts +44 -0
  192. package/src/clis/notion/status.ts +18 -0
  193. package/src/clis/notion/write.ts +45 -0
  194. package/src/clis/twitter/download.ts +227 -0
  195. package/src/clis/wechat/README.md +28 -0
  196. package/src/clis/wechat/README.zh-CN.md +28 -0
  197. package/src/clis/wechat/chats.ts +33 -0
  198. package/src/clis/wechat/contacts.ts +33 -0
  199. package/src/clis/wechat/read.ts +72 -0
  200. package/src/clis/wechat/search.ts +36 -0
  201. package/src/clis/wechat/send.ts +49 -0
  202. package/src/clis/wechat/status.ts +35 -0
  203. package/src/clis/xiaohongshu/creator-note-detail.ts +95 -0
  204. package/src/clis/xiaohongshu/creator-notes.ts +116 -0
  205. package/src/clis/xiaohongshu/creator-profile.ts +60 -0
  206. package/src/clis/xiaohongshu/creator-stats.ts +81 -0
  207. package/src/clis/xiaohongshu/download.ts +173 -0
  208. package/src/clis/xiaohongshu/search.ts +1 -1
  209. package/src/clis/xiaohongshu/user-helpers.test.ts +106 -0
  210. package/src/clis/xiaohongshu/user-helpers.ts +85 -0
  211. package/src/clis/xiaohongshu/user.ts +52 -32
  212. package/src/clis/zhihu/download.test.ts +12 -0
  213. package/src/clis/zhihu/download.ts +223 -0
  214. package/src/download/index.ts +395 -0
  215. package/src/download/progress.ts +125 -0
  216. package/src/engine.test.ts +17 -0
  217. package/src/main.ts +12 -3
  218. package/src/pipeline/registry.ts +2 -0
  219. package/src/pipeline/steps/download.ts +310 -0
  220. package/src/pipeline/template.ts +26 -0
  221. package/tests/e2e/browser-auth.test.ts +25 -0
@@ -0,0 +1,45 @@
1
+ site: linux-do
2
+ name: search
3
+ description: 搜索 linux.do
4
+ domain: linux.do
5
+ browser: true
6
+
7
+ args:
8
+ keyword:
9
+ type: str
10
+ required: true
11
+ description: Search keyword
12
+ limit:
13
+ type: int
14
+ default: 20
15
+ description: Number of results
16
+
17
+ pipeline:
18
+ - navigate: https://linux.do
19
+
20
+ - evaluate: |
21
+ (async () => {
22
+ const keyword = ${{ args.keyword | json }};
23
+ const res = await fetch('/search.json?q=' + encodeURIComponent(keyword), { credentials: 'include' });
24
+ if (!res.ok) throw new Error('HTTP ' + res.status + ' - 请先登录 linux.do');
25
+ let data;
26
+ try { data = await res.json(); } catch { throw new Error('响应不是有效 JSON - 请先登录 linux.do'); }
27
+ const topics = data?.topics || [];
28
+ return topics.slice(0, ${{ args.limit }}).map(t => ({
29
+ title: t.title,
30
+ views: t.views,
31
+ likes: t.like_count,
32
+ replies: (t.posts_count || 1) - 1,
33
+ }));
34
+ })()
35
+
36
+ - map:
37
+ rank: ${{ index + 1 }}
38
+ title: ${{ item.title }}
39
+ views: ${{ item.views }}
40
+ likes: ${{ item.likes }}
41
+ replies: ${{ item.replies }}
42
+
43
+ - limit: ${{ args.limit }}
44
+
45
+ columns: [rank, title, views, likes, replies]
@@ -0,0 +1,38 @@
1
+ site: linux-do
2
+ name: topic
3
+ description: linux.do 帖子详情和回复(首页)
4
+ domain: linux.do
5
+ browser: true
6
+
7
+ args:
8
+ id:
9
+ type: int
10
+ required: true
11
+ description: Topic ID
12
+
13
+ pipeline:
14
+ - navigate: https://linux.do
15
+
16
+ - evaluate: |
17
+ (async () => {
18
+ const res = await fetch('/t/${{ args.id }}.json', { credentials: 'include' });
19
+ if (!res.ok) throw new Error('HTTP ' + res.status + ' - 请先登录 linux.do');
20
+ let data;
21
+ try { data = await res.json(); } catch { throw new Error('响应不是有效 JSON - 请先登录 linux.do'); }
22
+ const strip = (html) => (html || '').replace(/<br\s*\/?>/gi, ' ').replace(/<\/(p|div|li|blockquote|h[1-6])>/gi, ' ').replace(/<[^>]+>/g, '').replace(/&nbsp;/g, ' ').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#(?:(\d+)|x([0-9a-fA-F]+));/g, (_, dec, hex) => { try { return String.fromCodePoint(dec !== undefined ? Number(dec) : parseInt(hex, 16)); } catch { return ''; } }).replace(/\s+/g, ' ').trim();
23
+ const posts = data?.post_stream?.posts || [];
24
+ return posts.map(p => ({
25
+ author: p.username,
26
+ content: strip(p.cooked).slice(0, 200),
27
+ likes: p.like_count,
28
+ created_at: p.created_at,
29
+ }));
30
+ })()
31
+
32
+ - map:
33
+ author: ${{ item.author }}
34
+ content: ${{ item.content }}
35
+ likes: ${{ item.likes }}
36
+ created_at: ${{ item.created_at }}
37
+
38
+ columns: [author, content, likes, created_at]
@@ -0,0 +1,29 @@
1
+ # Notion Desktop Adapter
2
+
3
+ Control the **Notion Desktop App** from the terminal via Chrome DevTools Protocol (CDP).
4
+
5
+ ## Prerequisites
6
+
7
+ Launch with remote debugging port:
8
+ ```bash
9
+ /Applications/Notion.app/Contents/MacOS/Notion --remote-debugging-port=9230
10
+ ```
11
+
12
+ ## Setup
13
+
14
+ ```bash
15
+ export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9230"
16
+ ```
17
+
18
+ ## Commands
19
+
20
+ | Command | Description |
21
+ |---------|-------------|
22
+ | `notion status` | Check CDP connection |
23
+ | `notion search "query"` | Quick Find search (Cmd+P) |
24
+ | `notion read` | Read the current page content |
25
+ | `notion new "title"` | Create a new page (Cmd+N) |
26
+ | `notion write "text"` | Append text to the current page |
27
+ | `notion sidebar` | List pages from the sidebar |
28
+ | `notion favorites` | List pages from the Favorites section |
29
+ | `notion export` | Export page as Markdown |
@@ -0,0 +1,29 @@
1
+ # Notion 桌面端适配器
2
+
3
+ 通过 Chrome DevTools Protocol (CDP) 在终端中控制 **Notion 桌面应用**。
4
+
5
+ ## 前置条件
6
+
7
+ 通过远程调试端口启动:
8
+ ```bash
9
+ /Applications/Notion.app/Contents/MacOS/Notion --remote-debugging-port=9230
10
+ ```
11
+
12
+ ## 配置
13
+
14
+ ```bash
15
+ export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9230"
16
+ ```
17
+
18
+ ## 命令
19
+
20
+ | 命令 | 说明 |
21
+ |------|------|
22
+ | `notion status` | 检查 CDP 连接 |
23
+ | `notion search "关键词"` | 快速搜索(Cmd+P) |
24
+ | `notion read` | 读取当前页面内容 |
25
+ | `notion new "标题"` | 新建页面(Cmd+N) |
26
+ | `notion write "文本"` | 在当前页面追加文字 |
27
+ | `notion sidebar` | 列出侧边栏页面列表 |
28
+ | `notion favorites` | 列出收藏夹页面列表 |
29
+ | `notion export` | 导出页面为 Markdown |
@@ -0,0 +1,36 @@
1
+ import * as fs from 'node:fs';
2
+ import { cli, Strategy } from '../../registry.js';
3
+ import type { IPage } from '../../types.js';
4
+
5
+ export const exportCommand = cli({
6
+ site: 'notion',
7
+ name: 'export',
8
+ description: 'Export the current Notion page as Markdown',
9
+ domain: 'localhost',
10
+ strategy: Strategy.UI,
11
+ browser: true,
12
+ args: [
13
+ { name: 'output', required: false, positional: true, help: 'Output file (default: /tmp/notion-export.md)' },
14
+ ],
15
+ columns: ['Status', 'File'],
16
+ func: async (page: IPage, kwargs: any) => {
17
+ const outputPath = (kwargs.output as string) || '/tmp/notion-export.md';
18
+
19
+ const result = await page.evaluate(`
20
+ (function() {
21
+ const titleEl = document.querySelector('[data-block-id] [placeholder="Untitled"], h1.notion-title, [class*="title"]');
22
+ const title = titleEl ? (titleEl.textContent || '').trim() : document.title;
23
+
24
+ const frame = document.querySelector('.notion-page-content, [class*="page-content"], main');
25
+ const content = frame ? (frame.innerText || '').trim() : document.body.innerText;
26
+
27
+ return { title, content };
28
+ })()
29
+ `);
30
+
31
+ const md = `# ${result.title}\n\n${result.content}`;
32
+ fs.writeFileSync(outputPath, md);
33
+
34
+ return [{ Status: 'Success', File: outputPath }];
35
+ },
36
+ });
@@ -0,0 +1,87 @@
1
+ import { cli, Strategy } from '../../registry.js';
2
+ import type { IPage } from '../../types.js';
3
+
4
+ export const favoritesCommand = cli({
5
+ site: 'notion',
6
+ name: 'favorites',
7
+ description: 'List pages from the Notion Favorites section in the sidebar',
8
+ domain: 'localhost',
9
+ strategy: Strategy.UI,
10
+ browser: true,
11
+ args: [],
12
+ columns: ['Index', 'Title', 'Icon'],
13
+ func: async (page: IPage) => {
14
+ const items = await page.evaluate(`
15
+ (function() {
16
+ const results = [];
17
+
18
+ // Strategy 1: Use Notion's own class 'notion-outliner-bookmarks-header-container'
19
+ const headerContainer = document.querySelector('.notion-outliner-bookmarks-header-container');
20
+ if (headerContainer) {
21
+ // Walk up to the section parent that wraps header + items
22
+ let section = headerContainer.parentElement;
23
+ if (section && section.children.length === 1) section = section.parentElement;
24
+
25
+ if (section) {
26
+ const treeItems = section.querySelectorAll('[role="treeitem"]');
27
+ treeItems.forEach((item) => {
28
+ // Title text is in a div.notranslate sibling of the icon area
29
+ const titleEl = item.querySelector('div.notranslate:not(.notion-record-icon)');
30
+ const title = titleEl
31
+ ? titleEl.textContent.trim()
32
+ : (item.textContent || '').trim().substring(0, 80);
33
+
34
+ // Icon/emoji is in the notion-record-icon element
35
+ const iconEl = item.querySelector('.notion-record-icon');
36
+ const icon = iconEl ? iconEl.textContent.trim().substring(0, 4) : '';
37
+
38
+ if (title && title.length > 0) {
39
+ results.push({ Index: results.length + 1, Title: title, Icon: icon || '📄' });
40
+ }
41
+ });
42
+ }
43
+ }
44
+
45
+ // Strategy 2: Fallback — find "Favorites" text node and walk DOM
46
+ if (results.length === 0) {
47
+ const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT, null);
48
+ let node;
49
+ let favEl = null;
50
+ while (node = walker.nextNode()) {
51
+ const text = node.textContent.trim();
52
+ if (text === 'Favorites' || text === '收藏' || text === '收藏夹') {
53
+ favEl = node.parentElement;
54
+ break;
55
+ }
56
+ }
57
+
58
+ if (favEl) {
59
+ let section = favEl;
60
+ for (let i = 0; i < 6; i++) {
61
+ const p = section.parentElement;
62
+ if (!p || p === document.body) break;
63
+ const treeItems = p.querySelectorAll(':scope > [role="treeitem"]');
64
+ if (treeItems.length > 0) { section = p; break; }
65
+ section = p;
66
+ }
67
+
68
+ const treeItems = section.querySelectorAll('[role="treeitem"]');
69
+ treeItems.forEach((item) => {
70
+ const text = (item.textContent || '').trim().substring(0, 120);
71
+ if (text && text.length > 1 && !text.match(/^(Favorites|收藏夹?)$/)) {
72
+ results.push({ Index: results.length + 1, Title: text, Icon: '📄' });
73
+ }
74
+ });
75
+ }
76
+ }
77
+
78
+ return results;
79
+ })()
80
+ `);
81
+
82
+ if (items.length === 0) {
83
+ return [{ Index: 0, Title: 'No favorites found. Make sure sidebar is visible and you have favorites.', Icon: '⚠️' }];
84
+ }
85
+ return items;
86
+ },
87
+ });
@@ -0,0 +1,39 @@
1
+ import { cli, Strategy } from '../../registry.js';
2
+ import type { IPage } from '../../types.js';
3
+
4
+ export const newCommand = cli({
5
+ site: 'notion',
6
+ name: 'new',
7
+ description: 'Create a new page in Notion',
8
+ domain: 'localhost',
9
+ strategy: Strategy.UI,
10
+ browser: true,
11
+ args: [
12
+ { name: 'title', required: false, positional: true, help: 'Page title (optional)' },
13
+ ],
14
+ columns: ['Status'],
15
+ func: async (page: IPage, kwargs: any) => {
16
+ const title = kwargs.title as string | undefined;
17
+
18
+ // Cmd+N creates a new page in Notion
19
+ const isMac = process.platform === 'darwin';
20
+ await page.pressKey(isMac ? 'Meta+N' : 'Control+N');
21
+ await page.wait(1);
22
+
23
+ // If title is provided, type it into the title field
24
+ if (title) {
25
+ await page.evaluate(`
26
+ (function(t) {
27
+ const titleEl = document.querySelector('[placeholder="Untitled"], [data-content-editable-leaf] [placeholder]');
28
+ if (titleEl) {
29
+ titleEl.focus();
30
+ document.execCommand('insertText', false, t);
31
+ }
32
+ })(${JSON.stringify(title)})
33
+ `);
34
+ await page.wait(0.5);
35
+ }
36
+
37
+ return [{ Status: title ? `Created page: ${title}` : 'New blank page created' }];
38
+ },
39
+ });
@@ -0,0 +1,33 @@
1
+ import { cli, Strategy } from '../../registry.js';
2
+ import type { IPage } from '../../types.js';
3
+
4
+ export const readCommand = cli({
5
+ site: 'notion',
6
+ name: 'read',
7
+ description: 'Read the content of the currently open Notion page',
8
+ domain: 'localhost',
9
+ strategy: Strategy.UI,
10
+ browser: true,
11
+ args: [],
12
+ columns: ['Title', 'Content'],
13
+ func: async (page: IPage) => {
14
+ const result = await page.evaluate(`
15
+ (function() {
16
+ // Get the page title
17
+ const titleEl = document.querySelector('[data-block-id] [placeholder="Untitled"], .notion-page-block .notranslate, h1.notion-title, [class*="title"]');
18
+ const title = titleEl ? (titleEl.textContent || '').trim() : document.title;
19
+
20
+ // Get the page content — Notion renders blocks in a frame
21
+ const frame = document.querySelector('.notion-page-content, [class*="page-content"], .layout-content, main');
22
+ const content = frame ? (frame.innerText || frame.textContent || '').trim() : '';
23
+
24
+ return { title, content };
25
+ })()
26
+ `);
27
+
28
+ return [{
29
+ Title: result.title || 'Untitled',
30
+ Content: result.content || '(empty page)',
31
+ }];
32
+ },
33
+ });
@@ -0,0 +1,54 @@
1
+ import { cli, Strategy } from '../../registry.js';
2
+ import type { IPage } from '../../types.js';
3
+
4
+ export const searchCommand = cli({
5
+ site: 'notion',
6
+ name: 'search',
7
+ description: 'Search pages and databases in Notion via Quick Find (Cmd+P)',
8
+ domain: 'localhost',
9
+ strategy: Strategy.UI,
10
+ browser: true,
11
+ args: [{ name: 'query', required: true, positional: true, help: 'Search query' }],
12
+ columns: ['Index', 'Title'],
13
+ func: async (page: IPage, kwargs: any) => {
14
+ const query = kwargs.query as string;
15
+
16
+ // Open Quick Find
17
+ const isMac = process.platform === 'darwin';
18
+ await page.pressKey(isMac ? 'Meta+P' : 'Control+P');
19
+ await page.wait(0.5);
20
+
21
+ // Type the search query
22
+ await page.evaluate(`
23
+ (function(q) {
24
+ const input = document.querySelector('input[placeholder*="Search"], input[type="text"]');
25
+ if (input) {
26
+ const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value').set;
27
+ setter.call(input, q);
28
+ input.dispatchEvent(new Event('input', { bubbles: true }));
29
+ }
30
+ })(${JSON.stringify(query)})
31
+ `);
32
+
33
+ await page.wait(1.5);
34
+
35
+ // Scrape results
36
+ const results = await page.evaluate(`
37
+ (function() {
38
+ const items = document.querySelectorAll('[role="option"], [class*="searchResult"], [class*="quick-find"] [role="button"]');
39
+ return Array.from(items).slice(0, 20).map((item, i) => ({
40
+ Index: i + 1,
41
+ Title: (item.textContent || '').trim().substring(0, 120),
42
+ }));
43
+ })()
44
+ `);
45
+
46
+ // Close Quick Find
47
+ await page.pressKey('Escape');
48
+
49
+ if (results.length === 0) {
50
+ return [{ Index: 0, Title: `No results for "${query}"` }];
51
+ }
52
+ return results;
53
+ },
54
+ });
@@ -0,0 +1,44 @@
1
+ import { cli, Strategy } from '../../registry.js';
2
+ import type { IPage } from '../../types.js';
3
+
4
+ export const sidebarCommand = cli({
5
+ site: 'notion',
6
+ name: 'sidebar',
7
+ description: 'List pages and databases from the Notion sidebar',
8
+ domain: 'localhost',
9
+ strategy: Strategy.UI,
10
+ browser: true,
11
+ args: [],
12
+ columns: ['Index', 'Title'],
13
+ func: async (page: IPage) => {
14
+ const items = await page.evaluate(`
15
+ (function() {
16
+ const results = [];
17
+ // Notion sidebar items
18
+ const selectors = [
19
+ '[class*="sidebar"] [role="treeitem"]',
20
+ '[class*="sidebar"] a',
21
+ '.notion-sidebar [role="button"]',
22
+ 'nav [role="treeitem"]',
23
+ ];
24
+
25
+ for (const sel of selectors) {
26
+ const nodes = document.querySelectorAll(sel);
27
+ if (nodes.length > 0) {
28
+ nodes.forEach((n, i) => {
29
+ const text = (n.textContent || '').trim().substring(0, 100);
30
+ if (text && text.length > 1) results.push({ Index: i + 1, Title: text });
31
+ });
32
+ break;
33
+ }
34
+ }
35
+ return results;
36
+ })()
37
+ `);
38
+
39
+ if (items.length === 0) {
40
+ return [{ Index: 0, Title: 'No sidebar items found. Toggle the sidebar first.' }];
41
+ }
42
+ return items;
43
+ },
44
+ });
@@ -0,0 +1,18 @@
1
+ import { cli, Strategy } from '../../registry.js';
2
+ import type { IPage } from '../../types.js';
3
+
4
+ export const statusCommand = cli({
5
+ site: 'notion',
6
+ name: 'status',
7
+ description: 'Check active CDP connection to Notion Desktop',
8
+ domain: 'localhost',
9
+ strategy: Strategy.UI,
10
+ browser: true,
11
+ args: [],
12
+ columns: ['Status', 'Url', 'Title'],
13
+ func: async (page: IPage) => {
14
+ const url = await page.evaluate('window.location.href');
15
+ const title = await page.evaluate('document.title');
16
+ return [{ Status: 'Connected', Url: url, Title: title }];
17
+ },
18
+ });
@@ -0,0 +1,45 @@
1
+ import { cli, Strategy } from '../../registry.js';
2
+ import type { IPage } from '../../types.js';
3
+
4
+ export const writeCommand = cli({
5
+ site: 'notion',
6
+ name: 'write',
7
+ description: 'Append text content to the currently open Notion page',
8
+ domain: 'localhost',
9
+ strategy: Strategy.UI,
10
+ browser: true,
11
+ args: [{ name: 'text', required: true, positional: true, help: 'Text to append to the page' }],
12
+ columns: ['Status'],
13
+ func: async (page: IPage, kwargs: any) => {
14
+ const text = kwargs.text as string;
15
+
16
+ // Focus the page body and move to the end
17
+ await page.evaluate(`
18
+ (function(text) {
19
+ // Find the editable area in Notion
20
+ const editables = document.querySelectorAll('.notion-page-content [contenteditable="true"], [class*="page-content"] [contenteditable="true"]');
21
+ let target = editables.length > 0 ? editables[editables.length - 1] : null;
22
+
23
+ if (!target) {
24
+ // Fallback: just find any contenteditable
25
+ const all = document.querySelectorAll('[contenteditable="true"]');
26
+ target = all.length > 0 ? all[all.length - 1] : null;
27
+ }
28
+
29
+ if (!target) throw new Error('Could not find editable area in Notion page');
30
+
31
+ target.focus();
32
+ // Move to end
33
+ const sel = window.getSelection();
34
+ sel.selectAllChildren(target);
35
+ sel.collapseToEnd();
36
+
37
+ document.execCommand('insertText', false, text);
38
+ })(${JSON.stringify(text)})
39
+ `);
40
+
41
+ await page.wait(0.5);
42
+
43
+ return [{ Status: 'Text appended successfully' }];
44
+ },
45
+ });