← Back to Skills Marketplace
404
Downloads
0
Stars
4
Active Installs
1
Versions
Install in OpenClaw
/install douyin-to-photos
Description
Build and maintain an Apple Shortcuts workflow that takes a Douyin share link, resolves a no-watermark MP4 URL via configurable backend APIs, saves the video...
README (SKILL.md)
Douyin-to-Photos
Use this skill to implement a one-tap Apple Shortcuts flow for authorized Douyin video archiving into Photos.
Hard Rules
- Process only links the user is allowed to download and store.
- Request only required permissions: network + Photos add-only.
- Keep all temporary files in Shortcuts temp folder and delete after import.
- Never persist user links, tokens, or media metadata outside local shortcut runtime.
Workflow
- Accept input from Share Sheet (
URLor text) or clipboard fallback. - Normalize and validate Douyin URL (
douyin.comoriesdouyin.com). - Resolve playable MP4 via API provider chain:
- Primary:
https://www.tikwm.com/api/ - Fallback: user-defined gateway API (for example self-hosted parser)
- Download MP4 to temporary file.
- Save to Photos (optionally target user-selected album).
- Delete temporary file and report success/failure.
Included Resources
scripts/fetch_douyin_no_watermark.sh: provider-chain URL resolver with timeout and structured errors.references/shortcut-build-guide.md: action-by-action Shortcuts build instructions.assets/skill-manifest.json: market-ready manifest template with parameterized options.
Integration Notes
- Share Sheet: enable
URLsinput type. - Back Tap: configure a tiny launcher shortcut that reads clipboard and calls the main shortcut.
- Keep API base URL and album name configurable via shortcut dictionary values.
Validation
- Run URL resolver script with a test share link before wiring into Shortcuts.
- Test four scenarios: success, invalid link, API timeout, API quota/blocked.
- Confirm temporary media file is deleted in both success and failure paths.
Usage Guidance
This skill appears to do what it says: it builds a Shortcuts workflow that posts a Douyin share link to a parser API, downloads the returned MP4, saves it to Photos, and cleans up. Before installing or running it: 1) Be aware that the default parser (https://www.tikwm.com/api/) is a third-party service — your shared URL (and any associated metadata) will be sent to that service and could be logged; if you care about privacy, configure a trusted/self-hosted fallback or remove the default. 2) The included resolver script requires curl and jq (not listed in metadata) for local testing — install those if you plan to run the script. 3) Confirm you have the right to download/save the content and that this use complies with Douyin/TikTok terms and local law. 4) Because the owner and homepage are not provided, prefer to review the script and shortcut JSON yourself before use; the code is small and readable, so auditing it locally is feasible. If you want higher assurance, ask the publisher to declare required binaries and to document the privacy properties of the default parser or provide a vetted self-hosted parser option.
Capability Analysis
Type: OpenClaw Skill
Name: douyin-to-photos
Version: 1.0.0
The skill bundle is designed to automate downloading Douyin videos without watermarks and saving them to Apple Photos, a common user request. It explicitly requests minimal permissions (`network`, `photos_add_only`), states it will not persist user data or telemetry, and includes clear instructions for temporary file cleanup. The `SKILL.md` and `references/shortcut-build-guide.md` provide transparent, benign instructions, reinforcing privacy and security best practices. The `scripts/fetch_douyin_no_watermark.sh` uses `curl` with `--data-urlencode` for the primary API, mitigating shell injection risks. While the fallback API call embeds the URL directly into a JSON string, this is a minor potential vulnerability in JSON formatting rather than evidence of intentional malicious behavior, especially given prior URL validation and the context of `curl`'s `--data` handling. No signs of data exfiltration, persistence, or obfuscation are present.
Capability Assessment
Purpose & Capability
The name/description, SKILL.md, manifest, shortcut logic, and the included resolver script are coherent: resolving a Douyin share link via an API and saving the resulting MP4 to Photos legitimately requires an API call and a downloader. One inconsistency: the script requires curl and jq to run, but the skill metadata lists no required binaries — these dependencies are implicit rather than declared.
Instruction Scope
Runtime instructions stay within the stated workflow (collect link, validate domain, call parser API chain, download file, save to Photos, clean up). However, the resolver sends the user-supplied share URL to external parser endpoints (default: https://www.tikwm.com/api/ and any user-configured fallback). That is necessary for the parsing approach but means the link (and possibly metadata) will be transmitted to third-party services despite 'privacy-safe' language in the docs.
Install Mechanism
This is instruction-only with a small helper script; there is no installer nor remote archive download. That keeps the disk/persistence footprint minimal. The script will be executed locally if you run validation, so its behavior (curl/jq network calls) is transparent and auditable.
Credentials
The skill requests no environment variables, credentials, or platform secrets. That is proportionate. Note: the manifest exposes a configurable fallback API endpoint — if a user sets that to an untrusted server it could receive every processed share URL and returned video URLs, so user choice matters for privacy.
Persistence & Privilege
The skill is not marked always:true and does not request elevated platform permissions beyond network and Photos-add (as documented). It does not attempt to modify other skills or system-wide settings. The SKILL.md emphasizes temporary-file cleanup and no storage; those are followed by the included script and Shortcuts guide.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install douyin-to-photos - After installation, invoke the skill by name or use
/douyin-to-photos - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of douyin-to-photos
- Enables one-tap Apple Shortcuts workflow to save Douyin videos (no watermark) directly to Photos.
- Supports input via Share Sheet or clipboard, with user-friendly error handling and privacy safeguards.
- Uses configurable backend APIs for MP4 resolution, including primary and fallback providers.
- All temporary files are cleaned after saving to Photos; no user data is persisted.
- Includes build instructions, provider-chain resolver script, and a manifest template for quick setup and customization.
Metadata
Frequently Asked Questions
What is Douyin To Photos?
Build and maintain an Apple Shortcuts workflow that takes a Douyin share link, resolves a no-watermark MP4 URL via configurable backend APIs, saves the video... It is an AI Agent Skill for Claude Code / OpenClaw, with 404 downloads so far.
How do I install Douyin To Photos?
Run "/install douyin-to-photos" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Douyin To Photos free?
Yes, Douyin To Photos is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Douyin To Photos support?
Douyin To Photos is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Douyin To Photos?
It is built and maintained by vahnxu (@vahnxu); the current version is v1.0.0.
More Skills