Pinterest Automation Setup for Goal-042

This document outlines the steps required to set up Pinterest API access for the automated goal `goal-042` of the "Lofi Cyberpunk Beats to Study To Radio" company.

1. Obtain Pinterest Access Token

To interact with the Pinterest API, a valid access token is required. This token grants the `pinterest_manager.py` script the necessary permissions to create boards and pins.

Steps to obtain the Access Token:

• Register as a Pinterest Developer: Visit the Pinterest Developers website and create a developer account if you don't already have one.
• Create an App: Create a new application within your Pinterest developer account. During app creation, you will need to specify a redirect URI. For local testing, `http://localhost/` or `https://example.com/` can be used. Ensure you request the necessary scopes for board and pin management (e.g., `boards:write`, `pins:write`, `user_accounts:read`).
• Perform OAuth Flow: Pinterest uses OAuth 2.0 for authentication. You will need to construct an authorization URL using your App ID and the requested scopes. Open this URL in a browser, log in to your Pinterest account, and grant your app permission.
• Capture the Access Token: After granting permission, Pinterest will redirect to your specified URI with the access token (or an authorization code you can exchange for a token) in the URL parameters. Copy this access token.

Note: Access tokens have an expiry. For long-term automation, you may need to implement a refresh token mechanism or periodically re-authenticate.

2. Set the Access Token as an Environment Variable

Once you have obtained the Pinterest Access Token, you need to make it available to the `pinterest_manager.py` script by setting it as an environment variable.

On macOS/Linux:

Open your terminal and add the following line to your shell configuration file (e.g., `~/.zshrc`, `~/.bash_profile`, or `~/.bashrc`):

export PINTEREST_ACCESS_TOKEN="YOUR_PINTEREST_ACCESS_TOKEN_HERE"

Important: Replace `YOUR_PINTEREST_ACCESS_TOKEN_HERE` with the actual token you obtained. After saving the file, run `source ~/.zshrc` (or your respective file) to apply the changes.

3. Verify Setup

To verify that the access token is correctly set and `pinterest_manager.py` can access it, you can run a simple test within your terminal:

python3 ~/.sovereign/company/companies/lofi-cyberpunk-beats-to-study-to-radio/projects/pinterest_manager.py

The script should no longer report "PINTEREST_ACCESS_TOKEN not set." messages for API calls. (Note: Actual API calls are commented out in the `if __name__ == "__main__":` block).

Next Steps

Once the `PINTEREST_ACCESS_TOKEN` is set, I can proceed with activating the board creation and pin automation using the Pinterest API.