GitHub 仓库 · 发布者 mareksulik

contentshot

Name: contentshot
Author: mareksulik

macOS 專用的 Claude Code 模改，按下兩個 ⌥ 鍵就能把目前瀏覽的文章、YouTube 字幕、Reddit 討論串、表格、PDF、郵件或 Finder 檔案內容附到下一次提示，並可存成 Obsidian Clippings 筆記。

mareksulik@mareksulik

mareksulik/contentshot

已翻译

关于这个 mod

contentshot 讓你按兩下 ⌥ 鍵，把眼前內容（選取文字、文章、YouTube 字幕、Reddit 討論串、社群貼文、廣告與分析後台表格、試算表、Google Docs、PDF、郵件、Finder 檔案等）以純文字擷取，附加到下一次 Claude Code 提示，也可依 Obsidian Web Clipper 格式存入指定的 Clippings 資料夾。內建 /contentshot 指令管理儲存資料夾、權限、重新啟動監聽器與狀態。需要 macOS、Xcode Command Line Tools，以及 Accessibility、Screen Recording、Input Monitoring 與瀏覽器 JavaScript from Apple Events 權限；所有資料留在本機，但擷取範圍可能包含私人內容。

安装

请先查看作者 README 确认 marketplace 和插件名称；命令可能随仓库结构改变。

claude plugin marketplace add mareksulik/contentshot
claude plugin install contentshot

原文 / README

contentshot

Press both ⌥ keys in any app and Claude gets the content you are looking at, not a picture of it: the article without the menus, the YouTube transcript, the Reddit thread with its comments, the table you selected. It is attached to your next Claude Code prompt and, if you choose a folder, saved as a note in Obsidian Clippings/ in the same format as the Obsidian Web Clipper.

contentshot is a Claude Code mod for the terminal and the Code tab of the Claude desktop app, macOS only. Its sibling appshot (⌘+⌘) sends a screenshot of the window instead.

What ⌥+⌥ takes

The most specific thing in front of you wins: selected text first, then the kind of page or app, else the window.

| Where you are | What it takes | Note tag | | --- | --- | --- | | Text selected anywhere | the selection and where it came from | selection | | Article in Safari, Chrome, Arc, Brave, Edge | the article text, title, author, date, URL | article | | YouTube video | transcript with timestamps, description, channel, the moment you are at | youtube | | Reddit thread | post and the whole comment tree, nested by reply | reddit | | X post | the post, the thread before it and the replies, without ads | x | | LinkedIn, Instagram, Threads, TikTok post | author, text, comments | linkedin, instagram, … | | Meta Ads Manager, GA4, Google Ads | the tables on screen, as Markdown | meta-ads, ga4, google-ads | | Google Sheets, Excel, Numbers | the selected cells; in Sheets with one cell selected, the whole sheet | sheet | | Google Docs | the document text | google-docs | | PDF in Preview or Acrobat | the whole text, page by page | pdf | | An image opened on its own in the browser | the image file | image | | Mail (selected message) | sender, recipients, date, attachments, body | email | | Finder with files selected | the files (prompt only) | — | | Finder with nothing selected | the folder and its contents (prompt only) | — | | Anything else | screenshot and window text (prompt only) | — |

The cards above the prompt show what is attached: 🔍 opens the saved note in Obsidian (or the source), ✕ drops it, and Odoslať ➤ sends it without typing a question (the desktop app keeps its own send button off while the prompt is empty).

Commands

| Command | What it does | | --- | --- | | /contentshot clippings <folder> | Save notes to this folder (your vault's Clippings); off stops saving | | /contentshot clear | Drop the pending contentshots | | /contentshot permissions | Ask macOS for the permissions contentshot needs | | /contentshot restart | Restart the ⌥+⌥ listener | | /contentshot status | Listener state, Clippings folder, pending count |

Requirements

macOS with the Xcode Command Line Tools (xcode-select --install), which provide swiftc.
In System Settings › Privacy & Security, allow the app that runs Claude Code under Accessibility, Screen Recording and Input Monitoring. /contentshot permissions raises the prompts.
Automation: macOS asks once per app (Safari, Chrome, Finder, Mail) the first time contentshot reads it.
Browsers: turn on Allow JavaScript from Apple Events (Safari › Settings › Developer; Chrome › View › Developer).

Privacy

contentshot has no server and collects nothing. What it takes stays on your Mac, in ~/.claude/contentshot/ and in the Clippings folder you choose, and reaches Anthropic only inside the Claude Code conversation you send it in, under your own account. What it reads can include private things (an email, an ad account's numbers), so press ⌥+⌥ only on what you mean to share with Claude and keep in your notes.

What it runs, reads and writes

Helper program. On first start the mod compiles helper/contentshot.swift with swiftc into ~/.claude/contentshot/bin/contentshot. It listens only to modifier keys, to notice both ⌥ keys; it does not see what you type. It reads the front app's name, window title, open document and selected text through the Accessibility API, extracts PDF text with PDFKit, and for tables presses ⌘C and puts your clipboard back right after.
Browser tabs. Through osascript it runs a read-only script in the front tab. That script may fetch, with your own login, the page's own data from the same site: a Reddit thread's .json, a Google Sheet's CSV export, a Google Doc's text export.
Other apps. osascript reads the Finder selection and the selected Mail message. screencapture takes the window when nothing else fits.
Downloads. An image opened on its own is fetched with curl from its own URL.
Files. Pending clips, screenshots and settings in ~/.claude/contentshot/; notes and images in your Clippings folder.
What Claude receives. Each pending clip is added to your next prompt as a <contentshot> block. The mod submits a prompt only when you press Odoslať ➤.

License

MIT

作品信息

作者: mareksulik
用途: 工作流与 CI
收录于: 2026年10月5日
来源更新: 2026年10月5日
星数: 0
权限足迹: L2
次浏览: 0

accessibilityclaude-codeclipboardmacosmodobsidianscreenshotworkflow

回报这个作品这是你的作品？认领

赞助

在此刊登，$10/周起

权限足迹 L2

权限足迹

数据来自自动扫描，安装前请自行查看源码。等级描述能力，不代表安全认证。

环境变量
读文件
写文件
执行命令
提交提示词

查看命中位置（33）

环境变量 · 第38 行hooks/register.tsxconst home = (await $.env.get('HOME')) ?? '/tmp'

读文件 · 第41 行hooks/register.tsxconst saved = await $.fs.read(settings).then(JSON.parse).catch(() => ({}))

写文件 · 第53 行hooks/register.tsxawait $.fs.write(paths.settings, JSON.stringify({ clippings: folder }, null, 2))

写文件 · 第58 行hooks/register.tsxawait $.fs.write(`${paths.data}/active`, await $.session.id()).catch(() => {})

读文件 · 第62 行hooks/register.tsxconst active = await $.fs.read(`${paths.data}/active`).catch(() => '')

写文件 · 第63 行hooks/register.tsxif (active.trim() === (await $.session.id())) await $.fs.write(`${paths.data}/active`, '').catch(() => {})

读文件 · 第69 行hooks/register.tsx(await $.fs.stat(paths.bin)).mtimeMs >= (await $.fs.stat(paths.src)).mtimeMs

执行命令 · 第72 行hooks/register.tsxawait $.process.run(['mkdir', '-p', `${paths.data}/bin`, `${paths.data}/pending`])

执行命令 · 第73 行hooks/register.tsx

const built = await $.process.run(['swiftc', '-O', '-swift-version', '5', '-o', paths.bin, paths.src], { timeoutMs: 300_000 })

执行命令 · 第81 行hooks/register.tsxconst result = await $.process.run(['osascript', '-l', 'JavaScript', '-e', script, ...args], { timeoutMs: 20_000 })

执行命令 · 第87 行hooks/register.tsxconst result = await $.process.run([paths.bin, mode, paths.data, ...args], { timeoutMs: 30_000 })

执行命令 · 第97 行hooks/register.tsxreturn app.windows[0].activeTab.execute({ javascript: argv[2] });

执行命令 · 第139 行hooks/register.tsxawait $.process.run(['mkdir', '-p', dir])

执行命令 · 第140 行hooks/register.tsxconst result = await $.process.run(['curl', '-sSLf', '--max-time', '20', '-o', target, url], { timeoutMs: 25_000 })

读文件 · 第202 行hooks/register.tsxconst entries = await $.fs.list(folder).catch(() => [])

写文件 · 第279 行hooks/register.tsxawait $.fs.write(target, noteText(clip, new Date().toISOString().slice(0, 10)))

执行命令 · 第288 行hooks/register.tsxawait $.process.run(['mkdir', '-p', `${paths.data}/shots`])

执行命令 · 第289 行hooks/register.tsx

const madeJpeg = await $.process.run(['sips', '-Z', '480', '-s', 'format', 'jpeg', '-s', 'formatOptions', '55', image, '--out', jpeg])

执行命令 · 第290 行hooks/register.tsxconst madePng = await $.process.run(['sips', '-Z', '480', '-s', 'format', 'png', image, '--out', png])

执行命令 · 第292 行hooks/register.tsxconst size = await $.process.run(['sips', '-g', 'pixelWidth', '-g', 'pixelHeight', jpeg])

执行命令 · 第295 行hooks/register.tsxconst encoded = await $.process.run(['base64', '-i', jpeg])

写文件 · 第376 行hooks/register.tsxawait $.fs.write(pendingPath(clip.id), JSON.stringify({ owner: await $.session.id(), clip })).catch(() => {})

执行命令 · 第381 行hooks/register.tsxawait $.process.run(['rm', '-f', ...clips.map(clip => pendingPath(clip.id))]).catch(() => {})

读文件 · 第390 行hooks/register.tsxconst entries = await $.fs.list(`${paths.data}/pending`).catch(() => [])

读文件 · 第394 行hooks/register.tsxconst record = await $.fs.read(`${paths.data}/pending/${entry.name}`).then(JSON.parse).catch(() => null)

写文件 · 第396 行hooks/register.tsxawait $.fs.write(pendingPath(record.clip.id), JSON.stringify({ owner: me, clip: record.clip }))

读文件 · 第408 行hooks/register.tsxconst owner = await $.fs.read(pendingPath(clip.id)).then(text => JSON.parse(text).owner).catch(() => null)

执行命令 · 第443 行hooks/register.tsxvoid $.process.run(['afplay', SOUND]).catch(() => {})

执行命令 · 第474 行hooks/register.tsxconst child = $.process.spawn({ argv: [paths.bin, 'listen', paths.data, await $.session.id()] })

环境变量 · 第545 行hooks/register.tsxconst folder = value.replace(/^~(?=\/)/, (await $.env.get('HOME')) ?? '~').replace(/\/$/, '')

执行命令 · 第557 行hooks/register.tsxconst asked = await $.process.run([paths.bin, 'permissions', paths.data], { timeoutMs: 20_000 })

执行命令 · 第594 行hooks/register.tsx{target && <Button key={`open-${clip.id}`} label="🔍" plain onPress={() => void $.process.run(['open', target])} />}

提交提示词 · 第630 行hooks/register.tsxawait $.prompt.submit({ text: draft || BARE_PROMPT, asUser: true })

contentshot

关于这个 mod

安装

contentshot

What ⌥+⌥ takes

Commands

Requirements

Privacy

What it runs, reads and writes

License

更多类似作品

ruflo-loop-workers

reflect-mod

crit-tui