Skip to main content

Export Intercom Help Center article URLs — ready to feed into AI tools like NotebookLM.

Project description

Intercom Docs Exporter

Export your Intercom Help Center article URLs into a single file. Filter by tags, collections, and publish state. Output as TXT or CSV.

Built to quickly feed help center docs into AI tools like NotebookLM.

Features

  • Filter articles by publish state, tags, and collections
  • Export as plain URL list (TXT) or with metadata (CSV)
  • Web interface for non-technical users
  • CLI for automation and scripting
  • Stateless: your API token is never stored

Quick Start (Web)

Visit intercom-docs-exporter.onrender.com and paste your Intercom API token.

Quick Start (CLI)

pip install intercom-docs-exporter

# Export all published articles
intercom-docs-exporter --token $INTERCOM_TOKEN

# Export with filters
intercom-docs-exporter --token $INTERCOM_TOKEN --include-tag Internal --format csv -o articles.csv

# List collections
intercom-docs-exporter --token $INTERCOM_TOKEN --list-collections

Examples

Feed your help center into NotebookLM:

# Export all published article URLs to a file
intercom-docs-exporter --token $INTERCOM_TOKEN -o urls.txt
# Upload urls.txt to NotebookLM as a source

Export only public-facing docs as CSV:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --exclude-tag Internal \
  --exclude-tag Draft \
  --format csv \
  -o public_articles.csv

Export a specific collection:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --collection "Getting Started" \
  -o getting_started.txt

Export everything except one collection:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --exclude-collection "Internal Docs" \
  --format csv \
  -o external.csv

Combine tag and collection filters:

intercom-docs-exporter --token $INTERCOM_TOKEN \
  --collection "API Reference" \
  --include-tag "v2" \
  --exclude-tag "deprecated" \
  -o api_v2.txt

Include draft articles too:

intercom-docs-exporter --token $INTERCOM_TOKEN --state both -o all_articles.txt

Help

intercom-docs-exporter --help
Option Description Default
--token Intercom API access token required
--state published, draft, or both published
--include-tag Only include articles with this tag (repeatable) all
--exclude-tag Exclude articles with this tag (repeatable) none
--collection Only include this collection (repeatable) all
--exclude-collection Exclude this collection (repeatable) none
--format txt or csv txt
-o, --output Output file path stdout
--list-collections List available collections and exit

Getting your API token:

  1. Go to your Intercom Developer Hub
  2. Select your app → Authentication
  3. Copy your access token

Your token is only used for the current request and is never stored.

Contributing

See CONTRIBUTING.md.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

intercom_docs_exporter-0.3.1.tar.gz (20.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

intercom_docs_exporter-0.3.1-py3-none-any.whl (17.1 kB view details)

Uploaded Python 3

File details

Details for the file intercom_docs_exporter-0.3.1.tar.gz.

File metadata

  • Download URL: intercom_docs_exporter-0.3.1.tar.gz
  • Upload date:
  • Size: 20.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.8

File hashes

Hashes for intercom_docs_exporter-0.3.1.tar.gz
Algorithm Hash digest
SHA256 dabe1cbf30db9b42f876f4cce83c7d224b788956e73b48977b9b49fa8ba1c3c2
MD5 0c6b0498e453cfbe109e3293ba82f75d
BLAKE2b-256 52f17c7679bb3e008e4eb95751b4d04f02cefbedf2346bf5163aa3908ffe0e12

See more details on using hashes here.

File details

Details for the file intercom_docs_exporter-0.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for intercom_docs_exporter-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2a1de0fcdf787ab76007992726a1235f3d6dc15de55cefe13f5b915e1c11a243
MD5 3a512e6a5a4140c0b5ae713bf05a5bde
BLAKE2b-256 7a79f4c01611d4b7de243eee8471c3640524130bf8ee75d7dc675b577804a531

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page