Как получить токен Threads* API из России: пошаговая инструкция и скрипт

Я делаю автопостинг в Threads*, и для этого нужен токен Threads* API. Это параметр без которого вы не сможет публиковать посты от имени вашего аккаунта. Официальная инструкция Meta* рассчитана на тех, кто живет без блокировок. Я живу в РФ и сложности подстерегают на каждом шагу:

  • аккаунт разработчика не подтверждался российским номером;
  • нельзя войти в Threads* напрямую, чтобы подтвердить выдачу токена,.

Ниже весь путь по шагам и скрипт, который превращает ссылку из браузера в долгоживущий токен на 60 дней.

* Instagram, Facebook и Threads принадлежат компании Meta, которая признана экстремистской организацией и запрещена в России.

Что понадобится

  • VPN
  • аккаунт Instagram* с созданным профилем Threads*;
  • аккаунт Facebook*: через него входят в кабинет разработчика Meta*;
  • номер телефона, который Meta* примет для подтверждения. У меня российский не прошёл, помог только реальный казахстанский;
  • компьютер с браузером: на телефоне шаг с подтверждением токена работает плохо, подробности ниже;
  • терминал (macOS или Linux) с curl и python3.

Шаг 1. Аккаунт разработчика

  1. Зайдите на developers.facebook.com под своим Facebook*-аккаунтом и нажмите «Начать» (Get Started).
  2. Meta попросит подтвердить номер телефона. С российским номером код у меня не приходил, не помогли даже виртуальные номера 5sim из Великобритании. Мне повезло, у меня есть казахстанский номер, на него дошли SMS. Подойдёт любой не российский номер, на который реально приходят SMS.
  3. Подтвердите почту и выберите роль (например, Developer).

Шаг 2. Приложение с доступом к Threads* API

  1. В кабинете откройте «Мои приложения» → «Создать приложение».
  2. В сценариях использования (Use cases) выберите Access the Threads* API.
  3. В настройках этого сценария (Customize) включите разрешения:threads_basic: базовый доступ к профилю;threads_content_publish: публикация постов;threads_manage_replies: ответы под постами. Без него при попытке опубликовать цепочку из поста и комментариев получите ошибку Application does not have permission for this action (code 10).
  4. В разделе настроек Threads укажите адрес перенаправления (Redirect Callback URL): https://localhost/. Поля Uninstall и Delete Callback URL тоже обязательны, туда можно вписать тот же адрес.
  5. Там же, в настройках сценария Threads*, найдите Threads* App ID и Threads* App Secret. Это не те ID и секрет, что в общих настройках приложения, а отдельная пара именно для Threads*. Перепутать их легко, и с чужой парой обмен кода на токен не сработает.

Шаг 3. Добавьте себя в тестировщики

Пока приложение в режиме разработки, токен можно получить только для аккаунтов-тестировщиков.

  1. В приложении откройте «Роли приложения» (App Roles) → «Роли» и добавьте свой ник в Threads* с ролью Threads* Tester.
  2. Приглашение нужно принять в самом Threads*. В веб-версии это «Настройки» → «Аккаунт» → «Разрешения для сайтов» → «Приглашения».

Чтобы принять приглашение в веб-версии, нужно в неё войти. Это тот же вход, что понадобится в шаге 4.

Шаг 4. Подтвердите доступ: главная засада

Теперь нужно открыть ссылку авторизации, в которой вместо ВАШ_THREADS_APP_ID стоит ваш Threads* App ID:

https://www.threads.net/oauth/authorize?client_id=ВАШ_THREADS_APP_ID&redirect_uri=https://localhost/&scope=threads_basic,threads_content_publish,threads_manage_replies&response_type=code

Threads* покажет, какие права запрашивает приложение, вы нажмёте «Разрешить», и браузер перейдёт на https://localhost/?code=.... Так это задумано. На деле:

  • на телефоне ссылка перекидывает в приложение Threads*, и там ничего не происходит;
  • на компьютере напрямую войти на threads.net у меня не получилось из за региональных ограничений (даже с VPN)

Что сработало:

  1. В том же браузере сначала войдите в Instagram* (instagram.com).
  2. Откройте threads.net. Сайт сам предложит продолжить с аккаунтом Instagram*. Соглашайтесь.
  3. Теперь, когда вы вошли в Threads*, откройте ссылку авторизации ещё раз и нажмите «Разрешить».

Порядок важен: сначала Instagram*, потом Thread*s через Instagram*, и только потом ссылка авторизации.

После подтверждения браузер откроет что-то вроде:

https://localhost/?code=AQBx...очень_длинная_строка...#_

Страница не загрузится, потому что на вашем компьютере нет сервера по этому адресу. Это нормально: нужна только адресная строка. Скопируйте адрес целиком.

Код из ссылки одноразовый и живёт около часа, поэтому следующий шаг лучше сделать сразу.

Шаг 5. Обменяйте код на долгоживущий токен

Код из ссылки сам по себе не токен. Его нужно обменять дважды:

  1. код → короткоживущий токен (действует около часа);
  2. короткоживущий → долгоживущий (действует 60 дней).

Я завернул оба обмена в скрипт. Он сам вырезает код из скопированного адреса (вместе с хвостом #_, который добавляет Threads*), проверяет полученный токен запросом к профилю и кладёт токен в буфер обмена. Секрет и код вводятся скрыто и никуда не сохраняются.

Сохраните скрипт как threads-token.sh:

#!/usr/bin/env bash # Threads: адрес с ?code=... → долгоживущий токен (60 дней). # Запуск: bash threads-token.sh # Спросит Threads App ID, Threads App Secret и код (или адрес целиком). set -euo pipefail # должен совпадать с redirect_uri из ссылки авторизации REDIRECT_URI="${THREADS_REDIRECT_URI:-https://localhost/}" # достаёт поле из JSON-ответа или выходит с ошибкой Threads json_field() { python3 -c ' import json, sys key = sys.argv[1] try: data = json.load(sys.stdin) except ValueError: sys.exit("Ответ не JSON") if key not in data: sys.exit("Ошибка Threads: " + json.dumps(data.get("error", data), ensure_ascii=False)) print(data[key], end="") ' "$1" } read -r -p "Threads App ID: " APP_ID read -r -s -p "Threads App Secret: " APP_SECRET; echo read -r -s -p "Code (или адрес целиком): " INPUT; echo # из адреса оставляем только значение code= (без &... и #_) CODE="${INPUT#*code=}" CODE="${CODE%%&*}" CODE="${CODE%%#*}" [[ -n "$APP_ID" && -n "$APP_SECRET" && -n "$CODE" ]] || { echo "Нужны App ID, App Secret и code" >&2; exit 1; } echo "Code → краткосрочный токен…" SHORT=$(curl -sS -X POST "https://graph.threads.net/oauth/access_token" \ --data-urlencode "client_id=$APP_ID" \ --data-urlencode "client_secret=$APP_SECRET" \ --data-urlencode "grant_type=authorization_code" \ --data-urlencode "redirect_uri=$REDIRECT_URI" \ --data-urlencode "code=$CODE" | json_field access_token) echo "Краткосрочный → долгосрочный (60 дней)…" LONG=$(curl -sS -G "https://graph.threads.net/access_token" \ --data-urlencode "grant_type=th_exchange_token" \ --data-urlencode "client_secret=$APP_SECRET" \ --data-urlencode "access_token=$SHORT" | json_field access_token) # проверка: токен рабочий, если Threads отдаёт ваш ник USERNAME=$(curl -sS -G "https://graph.threads.net/v1.0/me" \ --data-urlencode "fields=id,username" \ --data-urlencode "access_token=$LONG" | json_field username) if command -v pbcopy >/dev/null; then printf %s "$LONG" | pbcopy echo "Готово: @$USERNAME. Токен в буфере обмена." else echo "Готово: @$USERNAME. Токен:" echo "$LONG" fi

Запустите:

./bash threads-token.sh

Введите App ID и App Secret (их можно вставить из буфера обмена, ввод секрета просто не отображается). Затем вставьте скопированный адрес https://localhost/?code=.... Если всё прошло, скрипт напишет Готово: @ваш_ник. На macOS токен уже будет в буфере обмена, на Linux скрипт выведет его в терминал.

Если пишет Ошибка Threads*, чаще всего причина одна из трёх:

  • код уже использован или устарел. Откройте ссылку авторизации ещё раз и возьмите новый код;
  • указаны общие App ID и секрет приложения вместо пары из настроек Threads*;
  • redirect_uri в ссылке и в настройках приложения не совпадают до символа, включая слэш в конце.

Шаг 6. Не дайте токену протухнуть

Долгоживущий токен действует 60 дней, но его можно продлевать без повторной авторизации. Продлить можно токен, которому больше суток и который ещё не истёк:

curl -sS -G "https://graph.threads.net/refresh_access_token" \ --data-urlencode "grant_type=th_refresh_token" \ --data-urlencode "access_token=ВАШ_ТОКЕН"

В ответе будет новый токен ещё на 60 дней. В моём боте это делает ежедневная задача: продлевает токен, если до конца срока осталось меньше 10 дней. Достаточно один раз пройти инструкцию выше, дальше всё работает само.

Пара советов напоследок

  • Токен даёт полный доступ к публикации от вашего имени. Не отправляйте его в чаты и не коммитьте в репозиторий: храните в переменных окружения или в базе.
  • App Secret ещё важнее токена: с ним можно выпускать новые токены. Если он утёк, сгенерируйте новый в настройках приложения.
  • Если решите добавить права позже, например threads_manage_replies, старый токен их не получит. Нужно пройти шаги 4 и 5 заново со ссылкой, где в scope перечислены все нужные права.

Больше про разработку в канале https://t.me/five_a_m