Web Clipper on Shortcut: Safari Web Clipper Shortcut for Obsidian, Craft & Bear
Web Clipper on Shortcut is a free, open-source Safari web clipper built as an Apple Shortcut. With a single tap in the Share Sheet, you can grab the main content of any web page and save it as clean Markdown to Obsidian, Craft, or Bear on both iOS and macOS.
Unlike most web clippers, everything runs locally via Shortcuts — no browser extensions, no external servers, and the JavaScript source code is fully open for review.
Demo: Clip Web Pages from Safari to Obsidian, Craft, and Bear
Web Clipper on Shortcut currently supports clipping webpage content to three apps: Obsidian, Craft, and Bear:
Web Clipper on Shortcut can be used not only on iOS but also on macOS.
Quick start: install the iOS & macOS Shortcut
Install the Safari web clipper shortcut
First, click the icon above in the Safari browser to download and import Web Clipper on Shortcut into your Shortcuts app. Then, simply run Web Clipper on Shortcut directly from the Shortcuts app. If this is your first time using it, Web Clipper on Shortcut will immediately initiate the setup process, asking which app you want to clip content to and whether to enable automatic updates (enabling updates is recommended).
Configuration
Next, Web Clipper on Shortcut will guide you through an app-specific setup process based on your selected app. For example, if you choose Obsidian, Web Clipper on Shortcut will ask you to specify which Vault to save the clipped content in and the specific path within that Vault. Let’s assume the Vault is “Personal” and the path is “SimpleRead.” When you clip an article titled “hello clipper,” Web Clipper on Shortcut will create a file titled “hello clipper” in the “SimpleRead” directory of the “Personal” Vault.
Authorization
Finally, Web Clipper on Shortcut will attempt to download a JavaScript script for clipping from this website and request permission to write data to the clipboard. Simply allow all these permissions. For more details about the JavaScript script and clipboard permissions, refer to the subsequent sections.
Usage
Use the Shortcut from Safari’s Share Sheet to clip pages into Obsidian
Now the Web Clipper on Shortcut is ready to use. Let's try to clip a webpage.
Still taking clipping to Obsidian as an example, start by opening the webpage you want to clip in the Safari browser. Tap the “Share” button at the bottom, then select Web Clipper on Shortcut from the share menu. Since this is your first time using Web Clipper on Shortcut, the system will display several permission prompts—simply choose “Always Allow.” Next, the system will automatically launch the Obsidian app and create a file at the configured location. Then, in Obsidian’s editor, long-press to bring up the context menu and select “Paste” to complete the process.
You’ll notice that the pasted content isn’t the entire webpage but the “cleaned” main content of the webpage, which has already been converted into Markdown format supported by Obsidian.
Optimization
When Web Clipper on Shortcut is first installed, it is located at the bottom of the Safari browser's share sheet by default. To make it more convenient for us to use Web Clipper on Shortcut, we can also adjust its position in the share sheet.
Additional usage: Bear and Craft examples
Bear
If you wish to clip web content to Bear, the configuration is simpler. You only need to follow the initialization guide to complete the basic configuration of Web Clipper on Shortcut, as Bear does not require custom configurations like Vault in Obsidian. During the clipping operation, there is no need to manually perform the paste operation.
Craft
If you wish to clip web content to Craft, you first need to determine which Space you want to save the clipped content to, as well as the SpaceId of that Space. If you also want to save the clipped content to a specific folder, you need to obtain the FolderId of that folder in advance. A simple way to do this is to open your Space or folder in the web browser, where the URL in the address bar will contain the corresponding SpaceId and FolderId. The URL is generally in the following format:
https://docs.craft.do/s/UserName's-Space--xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/f/FolderName--xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
The first segment xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx is SpaceId,and the second xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx is FolderId。
If you choose to clip to Craft during the configuration guide of Web Clipper on Shortcut, the guide will prompt you to enter the SpaceId and FolderId in subsequent steps. The SpaceId is mandatory, while the FolderId can be left blank according to your personal needs.
After completing the configuration, when performing the clipping operation, it is also necessary to manually paste the content into the automatically created clipping file, just like with Obsidian. However, since the content to be pasted is prepared in advance by Web Clipper on Shortcut, this pasting process should take no more than two seconds.
Reset
All configuration information for Web Clipper on Shortcut is stored in the Shortcuts directory under your iCloud Drive. Opening the Shortcuts directory, you will find a folder named wcos, which contains all the JavaScript scripts and configuration information for Web Clipper on Shortcut. If you made a mistake during the previous configuration process or, for example, if you previously chose Obsidian as the clipping target but now wish to change it to Bear, you can simply delete the entire wcos folder and then rerun Web Clipper on Shortcut in the Shortcuts app. You will find that Web Clipper on Shortcut will rerun the configuration guide, and you can simply follow the new configuration process as before.
Update
If you selected “Enable Automatic Updates” during the setup, Web Clipper on Shortcut will automatically check for new versions the first time it runs each calendar month. If an update is available, it will notify you and guide you to this website. To update, simply delete the current Web Clipper on Shortcut from the Shortcuts app and download and install the latest version from this webpage.
If you didn’t enable automatic updates, you can manually check for updates at any time by opening the Shortcuts app and running Web Clipper on Shortcut. When Web Clipper on Shortcut detects that it wasn’t launched through the Safari browser, it will automatically enter the update check process. If a new version is available, you can update it by following the same steps mentioned above.
How Web Clipper on Shortcut works
Web Clipper on Shortcut runs entirely via Apple Shortcuts and JavaScript. It doesn’t rely on any external servers, so all processing happens on your device.
-
Run from Safari’s Share Sheet
You start the Shortcut from Safari’s Share Sheet (iOS and macOS). The current page URL gets passed into the Shortcut.
-
Extract the main content with JavaScript
The Shortcut loads a small JavaScript file that parses the page and extracts the main article content, removes navigation and ads, and converts it into Markdown.
-
Send the Markdown to your note app
For Bear, the Shortcut saves the Markdown directly into a new note;
For Obsidian and Craft, the Markdown is copied to your clipboard and you paste it into the target file or block.
All code runs locally on your device. You can review the exact JavaScript and Shortcut logic in the open-source repository.
Security and Privacy
As mentioned earlier, Web Clipper on Shortcut injects a JavaScript script into the webpage for execution during its runtime. This means that the JavaScript script has full access to the content of the webpage. Therefore, the system will notify you the first time you run Web Clipper on Shortcut on a new website. If the webpage you’re clipping contains sensitive information and the injected JavaScript script includes malicious code, there is a potential risk of this sensitive information being exposed. In fact, similar risks exist with most web clipping tools.
To avoid such issues and to alleviate concerns about data security when using Web Clipper on Shortcut, the Web Clipper on Shortcut is completely an open-source project. You can have the source code at SilentTiger/web-clipper-on-shortcut.
At the same time, Web Clipper on Shortcut performs an MD5 checksum on the JavaScript script before injecting it into a webpage to ensure that the script has not been tampered with, reducing data security risks. The verification criteria are stored in the shortcut’s source file, so you should not easily trust Web Clipper on Shortcut shortcut files sent by others. They might modify the MD5 criteria to introduce potentially unsafe JavaScript scripts.
Web Clipper on Shortcut does not rely on the network during its operation and does not send any data to third-party servers.
FAQ
-
Which apps does Web Clipper on Shortcut support?
Web Clipper on Shortcut currently supports clipping web page content to Obsidian, Craft, and Bear. Obsidian and Craft use a clipboard-based flow, while Bear can receive the clipped content directly via its URL scheme.
-
Does it work on both iOS and macOS?
Yes. As long as the Shortcuts app is available on your device, you can run Web Clipper on Shortcut from Safari’s share sheet on both iOS and macOS. The basic flow is the same: run the Shortcut from the share sheet, extract the main content, convert it to Markdown, and send it to the configured app.
-
Does it send my data to external servers? Is it safe for sensitive pages?
During normal use, Web Clipper on Shortcut does not send page content or your configuration to any external servers. The JavaScript that extracts the content runs locally on your device. If you are clipping very sensitive pages, you should still decide whether you are comfortable running any injected script on that page. For more details, see the Security and Privacy section above.
-
Why do I need to paste manually in Obsidian and Craft, but not in Bear?
For Obsidian and Craft, the Shortcut prepares cleaned Markdown and copies it to the clipboard, then opens a new note or document via URL scheme. These apps do not currently provide a reliable way to pass full page content directly, so you complete the last step by pasting. For Bear, its URL scheme allows the Shortcut to send the full content directly, so no manual paste is needed.
-
How do I reset the configuration or switch the target app?
All configuration is stored under your Shortcuts directory in iCloud Drive, in a folder named
wcos. If you misconfigured something or want to switch to a different app:- Open iCloud Drive →
Shortcutsdirectory. - Delete the
wcosfolder. - Run Web Clipper on Shortcut again from the Shortcuts app and follow the setup guide.
- Open iCloud Drive →
Feedback
If you have any problem when using Web Clipper on Shortcut, you can fire an issue at SilentTiger/web-clipper-on-shortcut.
Web Clipper on Shortcut currently supports only a limited number of apps. If you’d like it to support additional apps and the app you want can be launched via URL Scheme, you can submit an issue through the earlier link. I’ll address it as soon as I have time.
Of course, if you happen to have a basic understanding of JavaScript, you can write a launcher for the app you wish to support and submit a Pull Request to Web Clipper on Shortcut. The specific implementation of the launcher can be referred to in the src/launcher directory of the project.
Additionally, Web Clipper on Shortcut has only been optimized for a few specific websites. If you find that it does not perform well when clipping certain websites, such as not removing ads completely, you can raise an issue. Of course, it would be even better if you could implement a specific plugin and submit a pull request. The implementation of the plugin can be referred to in the src/plugin directory of the project.
Thanks and Acknowledgments
Thanks to the following projects for providing various supports to Web Clipper on Shortcut.
- mozilla/readability
- mozilla/readability is used to extract the main content of web pages and is also the foundational library for Firefox Reader View.
- cure53/DOMPurify
- cure53/DOMPurify is used to filter out unsafe parts of the main content.
- mixmark-io/turndown
- mixmark-io/turndown is used to convert the main content from HTML to Markdown.
- sofish/typo.css
- sofish/typo.css is used for the content layout and beautification of this webpage.