Migrate from Blogger using the Google API
npm install @tryghost/mg-bloggerMigrate from Blogger using the Google API
This tool requires an API key, which you can get here
You also need a blog ID, which is a long number like 12345678123456781234. You can find this by viewing the source of the Blogger site and looking for blogId.
To install the CLI, which is required for the Usage commands below:
``sh`
npm install --global @tryghost/migrate
To use this package in your own project:
npm install @tryghost/mg-blogger --save
or
yarn add @tryghost/mg-blogger
To run a Blogger migration, the required command is:
`sh`
migrate blogger --apiKey abcd --blogID 1234
It's possible to pass more options, in order to achieve a better migration file for Ghost:
- --apiKey (required)
- string - default: null--blogID
- API Key
- (required)null
- array - default: -V
- Comma separated list of site IDs
- --verbose false
- Show verbose output
- bool - default: --zip
- true
- Create a zip file
- bool - default: -s
- --scrape all
- Configure scraping tasks
- string - default: all
- Choices: , img, web, media, files, none--sizeLimit
- false
- number - default: 5
- Media files larger than this size (defined in MB [i.e. ]) will be flagged as oversize--addTag
- null
- string - default: --firstImageAsFeatured
- Provide a tag slug which should be added to every post in this migration
- true
- Use the first image as the post's feature_image
- bool - default: --fallBackHTMLCard
- true
- Fall back to convert to HTMLCard, if standard Mobiledoc convert fails
- bool - default: --cache
- --zip
- Persist local cache after migration is complete (Only if is true)true
- bool - default:
A more complex migration command could look like this:
`sh`
migrate blogger --apiKey abcd --blogID 1234, 5678 --addTag 'Blog Posts' --pages false
This will fetch posts only from 2 sites, and add a 'Blog Posts' tag to each post.
This is a mono repository, managed with lerna.
Follow the instructions for the top-level repo.
1. git clone this repo & cd into it as usualyarn
2. Run to install top-level dependencies.
To run a local development copy, cd into this directory, and use yarn dev instead of migrate like so:
`sh`
yarn dev blogger --apiKey abcd --blogID 1234
- yarn lint run just eslintyarn test` run lint and tests
-
Copyright (c) 2013-2026 Ghost Foundation - Released under the MIT license.