| name | audit-archive |
| title | Phase 6: Archive |
| description | Archives non-permanent URLs in legal document footnotes using the perma.cc API, then writes the resulting perma.cc links back to the DOCX file. Use this during a Bluebook audit workflow after footnote data has been extracted. |
| author | edwinhu |
| author_url | https://github.com/edwinhu/workflows/tree/main/skills/bluebook-audit/skills/audit-archive |
| license | MIT |
| version | 0.1.0 |
| execution_mode | open |
| jurisdiction | general |
| practice | general |
| language | en |
Phase 6: Archive
Archive all non-permanent URLs in footnotes via perma.cc API.
What This Phase Does
- Extract URL inventory from footnotes data
- Deduplicate URLs (same URL across multiple footnotes)
- Archive each URL via perma.cc API
- Write perma.cc links back to DOCX footnotes
- Save progress after each successful archive
Prerequisites
- Perma.cc API key in
.env file (project-level or user home directory)
- For institutional accounts: organization folder ID (unlimited archives)
- Free accounts: 10 links/month limit
Script
uv run python3 "${CLAUDE_SKILL_DIR}/../../../../skills/bluebook-audit/scripts/permacc_archive.py" --docx <path> --data scratch/footnotes_data.json
Institutional Account Setup
curl -H "Authorization: ApiKey YOUR_KEY" https://api.perma.cc/v1/organizations/
Use the folder parameter when creating archives:
requests.post("https://api.perma.cc/v1/archives/", json={
"url": url,
"folder": FOLDER_ID,
})
Gate: Exit Archive
Next Phase
Read ${CLAUDE_SKILL_DIR}/../../../../skills/bluebook-audit/skills/audit-crossrefs/SKILL.md and follow its instructions.
